次の方法で共有

copilotReportRoot: getMicrosoft365CopilotUsageUserDetail

重要

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

Microsoft 365 Copilot アプリが有効になっているユーザーの最新のアクティビティ データを取得します。

注:

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

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

アクセス許可

この 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

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail

関数パラメーター

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

パラメーター 型 説明
period 文字列 集計された使用状況を報告する前の日数。 サポートされる値は、 D7、 D30、 D90、 D180、 ALLです。 最初の 4 つの値は Dn という形式に従います。n は、データを集計する前の日数を表します。 ALL は、7 日、30 日、90 日、180 日間の使用状況を報告することを示します。

要求ヘッダー

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

要求本文

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

応答

成功した場合、この関数は 200 OK 応答コードと応答本文のストリームを返します。

例

要求

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

GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')?$format=application/json

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetail(period='D7')?$format=application/json

応答

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

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

{
  "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