重要
Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。
Microsoft Graph を使用すると、Microsoft 365 使用状況レポート リソースにアクセスして、ビジネスのユーザーが Microsoft 365 サービスを使用している方法に関する情報を取得できます。 たとえば、サービスを大量に使用していてクォータに達しているユーザーや、Microsoft 365 ライセンスがまったく必要ないユーザーを特定できます。
Microsoft 365 使用状況レポート データの情報の識別/識別解除を制御する設定の詳細については、 管理センターの「Microsoft 365 レポート 」を参照してください。
Authorization
Microsoft Graph では、アクセス許可を使用してリソースへのアクセスを制御します。 レポート リソースにアクセスするために必要なアクセス許可を指定する必要があります。 通常、Microsoft Entra 管理センターでアクセス許可を指定します。 詳細については、「Microsoft Graph のアクセス許可のリファレンス」および「Reports のアクセス許可」を参照してください。
設定
Microsoft 365 レポートでは、ユーザー名、グループ、サイトなどのユーザー情報が隠されます。実際の値は表示されません。 adminReportSettings API を使用して、レポート内のユーザー情報の表示を制御できます。
クラウド展開
以下の表は、すべてのクラウド展開での各 API の可用性を示します。
| API | Microsoft Graph グローバル サービス | Microsoft Cloud for US Government | 21Vianet によって運営されている Microsoft Cloud China | MICROSOFT Cloud for USNat および USSec |
|---|---|---|---|---|
| 管理者レポートの設定 | ✔ | ✔ | ✔ | ✔ |
| Microsoft 365 Copilot の使用状況 | ✔ | ➖ | ➖ | ➖ |
| Microsoft 365 のライセンス認証 | ✔ | ✔ | ✔ | ➖ |
| Microsoft 365 のアクティブ ユーザー | ✔ | ✔ | ✔ | ➖ |
| Microsoft 365 Apps の使用法 | ✔ | ✔ | ✔ | ➖ |
| Microsoft 365 ブラウザーの使用状況 | ✔ | ➖ | ➖ | ➖ |
| Microsoft 365 グループ アクティビティ | ✔ | ➖ | ✔ | ➖ |
| Microsoft Forms使用法 | ✔ | ➖ | ||
| Microsoft Graph APIの使用状況 | ✔ | ➖ | ➖ | ➖ |
| Microsoft Teams デバイスの利用状況 | ✔ | ✔ | ✔ | ✔ |
| Microsoft Teams のチーム アクティビティ | ✔ | ✔ | ✔ | ✔ |
| Microsoft Teams ユーザー アクティビティ | ✔ | ✔ | ✔ | ✔ |
| Outlook アクティビティ | ✔ | ✔ | ✔ | ✔ |
| Outlook アプリの使用状況 | ✔ | ✔ | ✔ | ✔ |
| Outlook メールボックスの使用状況 | ✔ | ✔ | ✔ | ✔ |
| OneDrive アクティビティ | ✔ | ✔ | ✔ | ✔ |
| OneDrive の使用状況 | ✔ | ✔ | ✔ | ✔ |
| SharePoint のアクティビティ | ✔ | ✔ | ✔ | ✔ |
| SharePoint サイトの利用状況 | ✔ | ✔ | ✔ | ✔ |
| Skype for Business アクティビティ | ✔ | ➖ | ✔ | ➖ |
| Skype for Business デバイスの使用状況 | ✔ | ➖ | ✔ | ➖ |
| Skype for Business 開催者アクティビティ | ✔ | ➖ | ✔ | ➖ |
| Skype for Business 参加者アクティビティ | ✔ | ➖ | ✔ | ➖ |
| Skype for Business ピアツーピア アクティビティ | ✔ | ➖ | ✔ | ➖ |
| Viva Engage アクティビティ | ✔ | ➖ | ➖ | ➖ |
| Viva Engage デバイスの使用状況 | ✔ | ➖ | ➖ | ➖ |
| Viva Engage グループ アクティビティ | ✔ | ➖ | ➖ | ➖ |
ライセンスのないCopilot Chat使用状況をプログラムでエクスポートする
現時点では、Copilot Chat使用状況レポートに含まれるライセンスのないユーザーのCopilot Chat使用状況データにアクセスできるパブリック Microsoft Graph APIまたは PowerShell コマンドレットはありません。
ライセンスのないCopilot Chat操作は、Microsoft Purview 統合監査ログにのみ記録されます。
統合監査ログから CopilotInteraction イベントを自動的に抽出するには、次のいずれかの方法を使用します。
-
PowerShell: Exchange Online PowerShell (EXO) の
Search-UnifiedAuditLogを使用して、CopilotInteractionイベントをフィルター処理し、CSV ファイルにエクスポートします。 Microsoft Graph PowerShell はSearch-UnifiedAuditLogを公開せず、統合監査ログに対してクエリを実行できません。 - Office 365管理アクティビティ API: この API を使用して、セキュリティ情報およびイベント管理 (SIEM) または分析プラットフォームに監査ログをStreamします。
次の手順
レポート リソースと API を使用すると、Microsoft Graph を使用してユーザーと関わり、エクスペリエンスを管理するための新しい方法を開くことができます。 詳細情報
- 特定のシナリオに役立つ、メソッドとリソースのプロパティを詳しく調べます。
- Graph エクスプローラーで API をお試しください。