teams_call_history

Microsoft Teams · macOS · Windows

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

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

macOS

目的

アカウントの直近 50 件のチャットで終了した Microsoft Teams の通話と会議を、Microsoft 365 から新しい順に一覧表示します。通話の種類（call、meeting、screenShare）、参加者、開始時刻と終了時刻、所要時間が含まれます。チャット外の通話（電話、チャットのないカレンダー会議）は一覧に含まれず、Microsoft は誰が通話を開始したか、応答されたかを提供しないため、direction と answered は常に空です。任意の since/until（YYYY-MM-DD）で期間を絞り込めます。直近 50 件のチャットを対象に、それぞれの削除されていない最新 50 件のメッセージを確認します（最大 50 件を 20 ページまで読み取り）。アカウントが読み取れないチャット（403 または 404）はスキップされ、skipped_chats に数えられます。読み取りがその上限、または呼び出しの時間切れで打ち切られた場合、応答に 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 calls to return (default 50), newest first",
      "type": "integer"
    },
    "since": {
      "description": "Only calls on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only calls on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

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

{
  "limit": 5
}

Windows

目的

Microsoft Graph（接続済みの Microsoft 365 アカウント）経由で、Microsoft Teams の通話と会議の履歴を読み取ります。最近の Teams チャットにある通話終了イベントから導き出されます。各通話には、参加者、開始/終了時刻、所要時間、通話の種類、安定した通話 id が含まれます。任意の since/until（YYYY-MM-DD）で期間を絞り込めます（例: 日次のコレクターが前日の通話を取得）。直近 50 件のチャットを対象に、それぞれの削除されていない最新 50 件のメッセージを確認します（最大 50 件を 20 ページまで読み取り）。アカウントが読み取れないチャット（403 または 404）はスキップされ、skipped_chats に数えられます。読み取りがその上限、または呼び出しの時間切れで打ち切られた場合、応答に truncated: true が付きます。

必須入力

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

権限と確認

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

このプラットフォームでは、ユーザーが許可したアプリ、アカウント、リソースだけを使用してください。接続と権限の要件については、このツールのプラットフォーム固有の説明を参照してください。このカタログは、追加の 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": "Max calls to return (default 50), newest first",
      "type": "integer"
    },
    "since": {
      "description": "Only calls on/after this date, YYYY-MM-DD (optional)",
      "type": "string"
    },
    "until": {
      "description": "Only calls on/before this date, YYYY-MM-DD (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

ドキュメント例

{
  "limit": 5
}