teams_read_channel_messages

Microsoft Teams · macOS · Windows

Etki: okuma. Durum: koşullu kullanılabilir.

“Koşullu kullanılabilirlik”, aracın sürüme, platforma, izinlere, hesaba veya yapılandırmaya bağlı olabileceğini belirtir. Her kurulumda etkin olduğu anlamına gelmez.

macOS

Amaç

Bir Microsoft Teams kanalının (team_id teams_list_teams içinden, channel_id teams_list_channels içinden) en son gönderilerini, en eskisi önce olmak üzere Microsoft 365'ten okur. Yalnızca üst düzey gönderiler: yanıtlar dahil değildir. Kanal iletilerini okumak, Microsoft 365 kuruluşunun bir yöneticisinin onayladığı bir izin gerektirir; onsuz yanıt consent_required olur ve ne yapılacağını söyler. 50 gönderilik en fazla 20 sayfa okunur, silinenler dahil. Okuma kesilirse (bu sınır nedeniyle ya da çağrının süresi dolduğu için) yanıtta truncated: true bulunur. Bir iş veya okul Microsoft 365 hesabının connect_m365_account ile bağlanmış olması gerekir (kişisel Microsoft hesaplarında Teams okuma yoktur). Hiçbir Microsoft 365 hesabı bağlı değilse bunun yerine bu Mac'teki Teams uygulamasının yerel önbelleğini okur (Full Disk Access gerektirir, saatler veya günlerce geride olabilir); yanıttaki source hangisinin yanıt verdiğini belirtir (graph veya local_cache).

Zorunlu girdiler

team_id
channel_id

Girdi adları aracın istediği biçimde aynen korunur. İngilizce kanonik teknik tanımlar aşağıdaki açılır şemadadır.

İzinler ve onay

Şema açık bir onay parametresi bildirmez. Bu, izinsiz işlem yapma yetkisi vermez; etkiyi inceleyin ve yetki alın.

Yalnızca kullanıcının bu platformda yetkilendirdiği uygulamaları, hesapları ve kaynakları kullanın. Bağlantı ve izin gereksinimleri için bu aracın platforma özgü açıklamasına bakın; bu katalog ek OAuth kapsamları veya OS yetkileri bulunduğunu ileri sürmez.

İngilizce kanonik teknik şema — macOS

{
  "properties": {
    "account": {
      "description": "Which connected Microsoft 365 account to use: its email (UPN), its id from list_m365_accounts, or its display name when unique. Leave it out to use the default account.",
      "type": "string"
    },
    "channel_id": {
      "description": "Channel ID from teams_list_channels",
      "type": "string"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id"
  ],
  "type": "object"
}

Belge örneği

teams_read_channel_messages için örnek belge. Bu örneği çalıştırmayın. Gösterilen bağımsız değişkenler kurgusal bir veri kümesine aittir; gerçek bir çağrıdan önce gerçek tanıtıcıları bulun ve izin alın.

{
  "channel_id": "demo-channel-001",
  "team_id": "demo-team-001"
}

Windows