reportRoot: getTeamsUserActivityCounts

名前空間: microsoft.graph

アクティビティの種類ごとに、Microsoft Teams アクティビティの数を取得します。 アクティビティは、Microsoft Teams ライセンスユーザーによって実行されます。

アクセス許可

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

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

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

HTTP 要求

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

関数パラメーター

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

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

要求ヘッダー

名前	説明
Authorization	ベアラー {token}。必須。

応答

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

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

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

• レポートの更新日
• レポート日付
• チーム チャット メッセージ
• メッセージの投稿
• 返信メッセージ
• 非公開チャット メッセージ
• 通話
• 会議
• オーディオ期間
• ビデオの再生時間
• 画面共有期間
• 開催された会議
• 出席した会議
• レポート期間

例

要求

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

GET https://graph.microsoft.com/v1.0/reports/getTeamsUserActivityCounts(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,Report Date,Team Chat Messages,Post Messages,Reply Messages,Private Chat Messages,Calls,Meetings,Audio Duration,Video Duration,Screen Share Duration,Meetings Organized,Meetings Attended,Report Period