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 通信管理者
  • レポート閲覧者

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

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 省略可能。 要求されたレポートのバージョン。 サポートされている値は、 v1 (既定値) と v2です。

レポートのバージョン

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

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

バージョン 2 レポートには、バージョン 1 のすべての情報が含まれています。その他の情報は次のとおりです。

  • すべてのアプリに送信されたプロンプト
  • Copilot Chat用に送信されたプロンプト (作業)
  • Copilot Chat用に送信されたプロンプト (Web)
  • すべてのアプリのアクティブな使用日数
  • Copilot Chat (作業) 最終アクティビティの日付
  • Copilot Chat (Web) 最終アクティビティの日付
  • Microsoft 365 Copilot最終アクティビティの日付
  • Edge Last Activity Date
  • 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
        }
      ]
    }
  ]
}
  • Last updated on