重要
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 をお試しください。