copilotReportRoot: getMicrosoft365CopilotUsageUserDetail

重要

/beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。

Microsoft 365 Copilot アプリが有効になっているユーザーの最新の使用状況データを取得します。

レポートのビューと名前の詳細については、「Microsoft 365 レポート - Microsoft 365 Copilot の使用状況」を参照してください。 Copilot 使用状況レポート API は、Microsoft Graph 名前空間で標準 REST API として使用できます。 詳細については、「Microsoft 365 Copilot API の概要」を参照してください。

注:

この API は、Microsoft 365 Copilot ライセンスを持つユーザーの使用状況データのみを返します。 ライセンスされていない Copilot Chat の使用状況データは、Microsoft Graph レポート API では利用できません。 代わりに、次のことができます。

  • Microsoft 365 管理センターでライセンスされていない使用状況を表示する Copilot Chat 使用状況レポート
  • Microsoft Purview 監査ログを介して監査データにアクセスする
  • Search-UnifiedAuditLog (PowerShell) または Office 365 マネージメント アクティビティ API を使用してプログラムでエクスポートする

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国
✅ ❌ ❌ ❌

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) Reports.Read.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション Reports.Read.All 注意事項なし。

重要

アプリがユーザーに代わってサービスの使用状況レポートを読み取ることを許可する委任されたアクセス許可の場合、テナント管理者は、次のいずれかの Microsoft Entra ID の制限付き管理者ロールをユーザーに割り当てる必要があります。

  • 社内管理者
  • AI 管理者
  • Exchange 管理者
  • SharePoint 管理者
  • Lync 管理者
  • Teams サービス管理者
  • Teams 通信管理者
  • レポート閲覧者

詳細については、「 API が Microsoft 365 の使用状況レポートを読み取るための承認」を参照してください。

HTTP 要求

GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period={period}, version={version})

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period={period}, version={version})

関数パラメーター

要求 URL で、次のクエリ パラメーターに値を指定します。

パラメーター 型 説明
period String 必須です。 集計使用状況を報告する過去の日数。 サポートされている値は、 version の値によって異なります。 v1、D7、D30、D90、D180、ALL です。 v2 の場合は、D7、D28、D90、D180、ALL です。 最初の 4 つの値はフォーマット Dn に従います。ここで、 n はデータを集計する過去の日数を表します。 ALL サポートされているすべての期間 ( v1 の場合は 7、30、90、および 180 日、 v2の場合は 7、28、90、および 180 日) の使用状況を報告することを示します。
version String 省略可能。 要求されたレポート バージョン。 サポートされている値は v2 (既定値) です。

レポートのバージョン

バージョン 1 レポートには、次の情報が含まれています。

  • レポートの更新日
  • ユーザー プリンシパル名
  • 表示名
  • 最後のアクティビティ日付
  • Copilot Chat のアクティビティの最終日
  • Microsoft Teams Copilot の最後のアクティビティの日付
  • Word Copilot の最後のアクティビティの日付
  • Excel Copilot の最後のアクティビティの日付
  • PowerPoint Copilot の最後のアクティビティの日付
  • Outlook Copilot の最後のアクティビティの日付
  • OneNote Copilot の最後のアクティビティの日付
  • Loop Copilot の最後のアクティビティの日付
  • レポート期間

バージョン 2 のレポートには、バージョン 1 のすべての情報と次の追加情報が含まれています。

  • すべてのアプリに送信されたプロンプト
  • Copilot Chat (職場) に送信されたプロンプト
  • Copilot Chat (Web) に送信されたプロンプト
  • すべてのアプリのアクティブな使用日数
  • Copilot Chat (職場) のアクティビティの最終日
  • Copilot Chat (Web) のアクティビティの最終日
  • Microsoft 365 Copilot の最後のアクティビティの日付
  • Edge の前回のアクティビティの日付
  • Copilot エージェントの最後のアクティビティの日付

要求ヘッダー

名前 説明
Authorization Bearer {token}. 必須です。 認証と認可についての詳細をご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

成功した場合、この関数は 200 OK 応答コードと応答本文のストリームを返します。 ストリームの内容は、要求されたレポートを含む CSV ファイルです。

成功した場合、この関数は 200 OK 応答コードと、要求されたレポートの JSON 表現を応答本文で返します。

例

要求

次の例は要求を示しています。

GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')

応答

次の例は応答を示しています。 ここに示す応答オブジェクトは、読みやすさのために短縮されている可能性があります。

HTTP/1.1 200 OK
Content-Type: application/octet-stream

Report Refresh Date,User Principal Name,Display Name,Last Activity Date,Copilot Chat Last Activity Date,Microsoft Teams Copilot Last Activity Date,Word Copilot Last Activity Date,Excel Copilot Last Activity Date,PowerPoint Copilot Last Activity Date,Outlook Copilot Last Activity Date,OneNote Copilot Last Activity Date,Loop Copilot Last Activity Date,Report Period
2026-07-03,E58EEF6A6BBD3D0293CB306D24A42057,6A4630397AAA1A9C8EED362168DC88A0,,,,,,,,,,7

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "reportRefreshDate": "2025-08-20",
      "userPrincipalName": "DC8C64D6EC3A3AA17481D7E5EB5B68A6",
      "displayName": "C65E8D8AFA0DAB9639EDFAAEA94AFE66",
      "lastActivityDate": "2025-08-20",
      "copilotChatLastActivityDate": "2025-08-16",
      "microsoftTeamsCopilotLastActivityDate": "2025-08-20",
      "wordCopilotLastActivityDate": "2025-08-06",
      "excelCopilotLastActivityDate": "",
      "powerPointCopilotLastActivityDate": "2025-03-26",
      "outlookCopilotLastActivityDate": "",
      "oneNoteCopilotLastActivityDate": "",
      "loopCopilotLastActivityDate": "",
      "copilotActivityUserDetailsByPeriod": [
        {
          "reportPeriod": 7
        }
      ]
    }
  ]
}
  • 最終更新: