teams_list_chats

Microsoft Teams · macOS · Windows

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

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

macOS

目的

Microsoft 365 アカウントの Microsoft Teams チャット（ダイレクトメッセージ、グループチャット、会議チャット）を、Microsoft 365 から最近アクティブな順に一覧表示します。各チャットには、id（teams_read_chat_messages 用）、タイトル、他の参加者、種類（oneOnOne、group、meeting）、最後のメッセージが含まれます。participants は自分以外のすべてのメンバーを示します。名前を読み取れなかったメンバーは、何も表示されないのではなく、"unnamed member"（または "unnamed member (external)"）と表示されます。participants_state は、どこまで信頼できるかを示します。resolved、unresolved（少なくとも 1 人が名前なし）、only_you（チャットに他に誰もいない）、unknown（メンバーリストを読み取れなかった。その場合 participant_count と has_external_members は含まれません）のいずれかです。50 件のチャットを 20 ページまで読み取ります。読み取りがその上限、または呼び出しの時間切れで打ち切られた場合、応答に truncated: true が付きます。connect_m365_account で接続された、職場または学校の Microsoft 365 アカウントが必要です（個人の Microsoft アカウントでは Teams の読み取りはできません）。Microsoft 365 アカウントがまったく接続されていない場合は、代わりにこの Mac 上の Teams アプリのローカルキャッシュを読み取ります（フルディスクアクセスが必要で、数時間から数日遅れていることがあります）。応答の source は、どちらが応答したかを示します（graph または local_cache）。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

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

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の 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"
    },
    "limit": {
      "description": "Max items to return (default 50)",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

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

{
  "limit": 5
}

Windows

目的

接続済みの Microsoft 365 アカウントを使って、Microsoft Graph 経由で最近の Microsoft Teams チャットの会話を一覧表示します。50 件のチャットを 20 ページまで読み取ります。読み取りがその上限、または呼び出しの時間切れで打ち切られた場合、応答に truncated: true が付きます。participants は自分以外のすべてのメンバーを示します。名前を読み取れなかったメンバーは、何も表示されないのではなく、"unnamed member"（または "unnamed member (external)"）と表示されます。participants_state は、どこまで信頼できるかを示します。resolved、unresolved（少なくとも 1 人が名前なし）、only_you（チャットに他に誰もいない）、unknown（メンバーリストを読み取れなかった。その場合 participant_count と has_external_members は含まれません）のいずれかです。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

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

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の 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"
    },
    "limit": {
      "description": "Maximum chats to return (default: 50)",
      "type": "number"
    }
  },
  "type": "object"
}

ドキュメント例

{
  "limit": 5
}