copilotReportRoot: getMicrosoft365CopilotUsageUserDetailByDate

重要

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

選択した 1 つの日付に報告されたすべてのユーザーのユーザー レベルの Microsoft 365 Copilot 使用状況の詳細を取得します。

レポートのビューと名前の詳細については、「Microsoft 365 レポート - Microsoft 365 Copilot の使用状況」を参照してください。 Copilot 使用状況レポート API は、Microsoft Graph 名前空間で標準 REST API として使用できます。 詳細については、「Microsoft 365 Copilot 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/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetailByDate(date={date})

関数パラメーター

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

パラメーター 型 説明
date Date 必須です。 ユーザーのアクティビティを返す日付。 値は YYYY-MM-DD 形式を使用し、最新のレポート更新日の 7 日前から更新日までの値である必要があります。 可用性ウィンドウは、現在のカレンダーの日付ではなく、 reportRefreshDateに基づきます。 たとえば、レポートの最新の更新日が 2026 年 9 月 17 日の場合、有効な値は 2026 年 9 月 10 日から 2026 年 9 月 17 日までです。

オプションのクエリ パラメーター

このメソッドでは、応答のカスタマイズに役立つ OData クエリ パラメーター はサポートされていません。

要求ヘッダー

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

要求本文

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

応答

成功した場合、この関数は 200 OK 応答コードと、要求されたレポートの JSON 表現を応答本文で返します。 レポートの各行には、次のプロパティが含まれています。

プロパティ 型 説明
allAppsCopilotActionCount Int64 サポートされているすべてのアプリケーションにわたる Copilot アクションの数。
businessChatWebPromptsCount Int64 Web 上の Business Chat を通じて送信されたプロンプトの数。
displayName 文字列 レポートの設定に応じて、ユーザーの表示名または非表示識別子。
isActive ブール型 報告された Copilot エクスペリエンスのいずれかでユーザーがアクティブであったかどうか。
isActiveInBusinessChatWeb ブール型 Web 上の Business Chat でのアクティビティ。
isActiveInEdge ブール型 Microsoft Edge でのアクティビティ。
isActiveInExcel ブール型 Microsoft Excel でのアクティビティ。
isActiveInLoop ブール型 Microsoft Loop のアクティビティ。
isActiveInM365Chat ブール型 Microsoft 365 Chat でのアクティビティ。
isActiveInM365CopilotChatCopilotApp ブール型 Microsoft 365 Copilot アプリの Microsoft 365 Copilot Chat でのアクティビティ。
isActiveInOneNote ブール型 Microsoft OneNote でのアクティビティ。
isActiveInOutlook ブール型 Microsoft Outlook でのアクティビティ。
isActiveInPowerPoint ブール型 Microsoft PowerPoint でのアクティビティ。
isActiveInTeams ブール型 Microsoft Teams でのアクティビティ。
isActiveInWord ブール型 Microsoft Word でのアクティビティ。
m365ChatQueriesSubmitted Int64 Microsoft 365 Chat を通じて送信されたクエリの数。
reportRefreshDate Date レポート データが更新された日付。
reportSelectedDate Date 要求によって選択された日付。
userPrincipalName 文字列 レポートの設定に応じて、ユーザー プリンシパル名または非表示識別子。

例

要求

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

GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUsageUserDetailByDate(date=2026-09-14)

応答

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

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

{
  "value": [
    {
      "reportRefreshDate": "2026-09-17",
      "reportSelectedDate": "2026-09-14",
      "userPrincipalName": "DC8C64D6EC3A3AA17481D7E5EB5B68A6",
      "displayName": "C65E8D8AFA0DAB9639EDFAAEA94AFE66",
      "allAppsCopilotActionCount": 10,
      "m365ChatQueriesSubmitted": 3,
      "businessChatWebPromptsCount": 7,
      "isActive": true,
      "isActiveInTeams": false,
      "isActiveInWord": false,
      "isActiveInPowerPoint": false,
      "isActiveInExcel": true,
      "isActiveInOutlook": false,
      "isActiveInOneNote": false,
      "isActiveInLoop": false,
      "isActiveInM365Chat": true,
      "isActiveInBusinessChatWeb": true,
      "isActiveInEdge": false,
      "isActiveInM365CopilotChatCopilotApp": false
    }
  ]
}
  • 最終更新: