teams_read_channel_messages

Microsoft Teams · macOS · Windows

効果: 読み取り. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

Microsoft 365 から、Microsoft Teams チャネルの直近の投稿（team_id は teams_list_teams、channel_id は teams_list_channels から）を古い順に読み取ります。トップレベルの投稿のみで、返信は含まれません。チャネルメッセージの読み取りには、Microsoft 365 組織の管理者が承認する権限が必要です。権限がない場合、応答は consent_required となり、対処方法が示されます。最大 20 ページ、1 ページ 50 件の投稿を読み取り、削除されたものも含まれます。読み取りがその上限、または呼び出しの時間切れで打ち切られた場合、応答には truncated: true が付きます。connect_m365_account で接続した職場または学校の Microsoft 365 アカウントが必要です（個人の Microsoft アカウントでは Teams を読み取れません）。Microsoft 365 アカウントがまったく接続されていない場合は、代わりにこの Mac 上の Teams アプリのローカルキャッシュを読み取ります（フルディスクアクセスが必要で、数時間から数日遅れていることがあります）。応答の source は、どちらが応答したか（graph または local_cache）を示します。

必須入力

team_id
channel_id

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — 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"
}

ドキュメント例

teams_read_channel_messages のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

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

Windows

目的

特定の Teams チャネルのメッセージを読み取ります（トップレベルの投稿のみで、返信は含まれません）。最大 20 ページ、1 ページ 50 件の投稿を読み取り、削除されたものも含まれます。読み取りがその上限、または呼び出しの時間切れで打ち切られた場合、応答には truncated: true が付きます。

必須入力

team_id
channel_id

入力名はツールが要求する正確な形式のままです。英語の正規技術定義は下の展開可能なスキーマにあります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の OAuth スコープや OS 権限があるとは主張しません。

英語の正規技術スキーマ — Windows

{
  "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 (within that team)",
      "type": "string"
    },
    "limit": {
      "description": "Maximum messages (default: 50)",
      "type": "number"
    },
    "team_id": {
      "description": "Team ID from teams_list_teams",
      "type": "string"
    }
  },
  "required": [
    "team_id",
    "channel_id"
  ],
  "type": "object"
}

ドキュメント例

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