重要
/beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。
指定した期間の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 通信管理者
- グローバル閲覧者
- 使用状況の概要レポート閲覧者
- レポート閲覧者
詳細については、「 Microsoft 365 使用状況レポートを読み取るための API の承認」を参照してください。
HTTP 要求
GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUserCountSummary(period={period})
GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountSummary(period={period})
関数パラメーター
要求 URL で、次のクエリ パラメーターに値を指定します。
| パラメーター | 型 | 説明 |
|---|---|---|
period |
文字列 | 集計された使用状況を報告する前の日数。 サポートされる値は、 D7、 D30、 D90、 D180、 ALLです。 最初の 4 つの値は Dn という形式に従います。n は、データを集計する日数を表します。
ALL は、7 日、30 日、90 日、180 日間の使用状況を報告することを示します。 |
要求ヘッダー
| 名前 | 説明 |
|---|---|
Authorization |
Bearer {token}. 必須です。
認証と認可についての詳細をご覧ください。 |
要求本文
このメソッドには、要求本文を指定しません。
応答
成功した場合、この関数は200 OK応答コードと応答本文にStreamを返します。
例
要求
次の例は要求を示しています。
GET https://graph.microsoft.com/v1.0/copilot/reports/getMicrosoft365CopilotUserCountSummary(period='D7')?$format=application/json
GET https://graph.microsoft.com/beta/copilot/reports/getMicrosoft365CopilotUserCountSummary(period='D7')?$format=application/json
応答
次の例は応答を示しています。 ここに示す応答オブジェクトは、読みやすさのために短縮されている可能性があります。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 537
{
"value": [
{
"reportRefreshDate": "2025-08-20",
"adoptionByProduct": [
{
"reportPeriod": 7,
"anyAppEnabledUsers": 359229,
"anyAppActiveUsers": 165115,
"microsoftTeamsEnabledUsers": 359096,
"microsoftTeamsActiveUsers": 123341,
"wordEnabledUsers": 359096,
"wordActiveUsers": 21459,
"powerPointEnabledUsers": 359096,
"powerPointActiveUsers": 8530,
"outlookEnabledUsers": 359096,
"outlookActiveUsers": 37270,
"excelEnabledUsers": 359096,
"excelActiveUsers": 6709,
"oneNoteEnabledUsers": 359096,
"oneNoteActiveUsers": 1660,
"loopEnabledUsers": 359096,
"loopActiveUsers": 1345,
"copilotChatEnabledUsers": 359096,
"copilotChatActiveUsers": 65480
}
]
}
]
}