reportRoot: getOffice365ServicesUserCounts

名前空間: microsoft.graph

アクティビティの種類とサービス別のユーザー数を取得します。

注: 各レポートのビューとレポート名の詳細については、「Microsoft 365 レポート:　アクティブなユーザー」を参照してください。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校アカウント)	Reports.Read.All
委任 (個人用 Microsoft アカウント)	サポートされていません。
アプリケーション	Reports.Read.All

注: アプリがユーザーの代わりにサービスの利用状況レポートを読み込むことを許可するための委任されたアクセス許可については、テナント管理者は適切な Azure AD の制限付き管理者ロールをユーザーに割り当てておく必要があります。詳細については、「Microsoft 365 利用状況レポートを読み込むための API 用の承認」を参照してください。

HTTP 要求

GET /reports/getOffice365ServicesUserCounts(period='{period_value}')

関数パラメーター

要求 URL に、次のパラメーターと有効な値を指定します。

パラメーター	型	説明
period	文字列	レポートを集計する期間の長さを指定します。 {period_value} でサポートされている値は D7、D30、D90、D180 です。 これらの値は、D n の形式 (n はレポートを集計する日数) に従います。 必須。

要求ヘッダー

名前	説明
Authorization	ベアラー {トークン}。必須。
If-None-Match	この要求ヘッダーが含まれている場合、指定された eTag がファイルの現在のタグに一致すると、304 Not Modified 応答コードが返されます。省略可能。

応答

成功すると、レポートの事前認証されたダウンロード URL にリダイレクトする 302 Found 応答が返されます。 その URL は、応答の Location ヘッダー内にあります。

事前認証されたダウンロード URL は、短期間 (数分) のみ有効で、Authorization ヘッダーを必要としません。

この CSV ファイルには、次の列ヘッダーがあります。

• レポートの更新日
• Exchange アクティブ
• Exchange 非アクティブ
• OneDrive アクティブ
• OneDrive 非アクティブ
• SharePoint アクティブ
• SharePoint 非アクティブ
• Skype For Business アクティブ
• Skype For Business 非アクティブ
• Yammer アクティブ
• Yammer 非アクティブ
• Teams アクティブ
• Teams 非アクティブ
• Office 365Active
• Office 365非アクティブ
• レポート期間

例

要求

要求の例を次に示します。

GET https://graph.microsoft.com/v1.0/reports/getOffice365ServicesUserCounts(period='D7')

応答

応答の例を次に示します。

HTTP/1.1 302 Found
Content-Type: text/plain
Location: https://reports.office.com/data/download/JDFKdf2_eJXKS034dbc7e0t__XDe

302 リダイレクトに従うと、ダウンロードされる CSV ファイルは次のスキーマを持つことになります。

HTTP/1.1 200 OK
Content-Type: application/octet-stream

Report Refresh Date,Exchange Active,Exchange Inactive,OneDrive Active,OneDrive Inactive,SharePoint Active,SharePoint Inactive,Skype For Business Active,Skype For Business Inactive,Yammer Active,Yammer Inactive,Teams Active,Teams Inactive,Office 365 Active,Office 365 Inactive,Report Period