reportRoot: getOffice365ActiveUserDetail

名前空間: microsoft.graph

Microsoft 365 アクティブ ユーザーに関する詳細を取得します。

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

アクセス許可

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

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

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

HTTP 要求

GET /reports/getOffice365ActiveUserDetail(period='{period_value}')
GET /reports/getOffice365ActiveUserDetail(date={date_value})

関数パラメーター

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

パラメーター	型	説明
period	文字列	レポートを集計する期間の長さを指定します。 {period_value} でサポートされている値は D7、D30、D90、D180 です。 これらの値は、D n の形式 (n はレポートを集計する日数) に従います。
date	日付	何らかのアクティビティを実行したユーザーを表示する日付を指定します。 {date_value} は YYYY-MM-DD の形式にします。 このレポートは、過去 30 日間のみ利用可能であり、{date_value} はその範囲内の日付である必要があります。

注: URL に期間または日付を設定する必要があります。

要求ヘッダー

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

応答

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

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

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

• レポートの更新日
• ユーザー プリンシパル名
• 表示名
• 削除済み
• 削除日
• Exchange ライセンスがある
• OneDrive ライセンスがある
• SharePoint ライセンスがある
• Skype for Business ライセンスがある
• Yammer ライセンスがある
• Teams ライセンスがある
• Exchange の最後のアクティビティ日付
• OneDrive の最後のアクティビティ日付
• SharePoint の最後のアクティビティ日付
• Skype For Business の最後のアクティビティ日付
• Yammer の最後のアクティビティ日付
• Teams の最後のアクティビティ日付
• Exchange のライセンス割り当て日
• OneDrive のライセンス割り当て日
• SharePoint のライセンス割り当て日
• Skype For Business のライセンス割り当て日
• Yammer のライセンス割り当て日
• Teams のライセンス割り当て日
• 割り当て済み製品

例

要求

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

GET https://graph.microsoft.com/v1.0/reports/getOffice365ActiveUserDetail(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,User Principal Name,Display Name,Is Deleted,Deleted Date,Has Exchange License,Has OneDrive License,Has SharePoint License,Has Skype For Business License,Has Yammer License,Has Teams License,Exchange Last Activity Date,OneDrive Last Activity Date,SharePoint Last Activity Date,Skype For Business Last Activity Date,Yammer Last Activity Date,Teams Last Activity Date,Exchange License Assign Date,OneDrive License Assign Date,SharePoint License Assign Date,Skype For Business License Assign Date,Yammer License Assign Date,Teams License Assign Date,Assigned Products