Method: userUsageReport.get

アカウントを持つユーザーのセットのプロパティと統計情報のコレクションであるレポートを取得します。詳しくは、ユーザー使用状況レポートガイドをご覧ください。ユーザー レポートのパラメータの詳細については、ユーザー使用状況パラメータのリファレンス ガイドをご覧ください。

HTTP リクエスト

GET https://admin.googleapis.com/admin/reports/v1/usage/users/{userKey or all}/dates/{date}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
userKey or all

string

データをフィルタするプロファイル ID またはユーザーのメールアドレスを表します。すべての情報を表示する場合は all に、ユーザーの一意の Google Workspace プロフィール ID またはメインのメールアドレスを使用する場合は userKey を指定します。削除済みのユーザーは使用できません。削除されたユーザーについては、 showDeleted=true を使用して Directory API で users.list を呼び出し、返された ID を userKey として使用します。
date

string

使用量が発生した日付を UTC-8:00（太平洋標準時）で表します。タイムスタンプは ISO 8601 形式の yyyy-mm-dd です。

クエリ パラメータ

パラメータ
customerId

string

データを取得する顧客の一意の ID。
filters

string

filters クエリ文字列はアプリケーションのイベント パラメータのカンマ区切りのリストで、パラメータの値は関係演算子によって操作されます。filters クエリ文字列には、レポートに使用状況が返されるアプリケーションの名前が含まれます。ユーザー使用状況レポートのアプリケーション値には、accounts、docs、gmail があります。

フィルタの形式は [application name]:[parameter name][relational operator][parameter value],... です。

この例では、リクエストのクエリ文字列（%3C%3E）内で <> の「等しくない」演算子が URL エンコードされています。

GET
https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03
?parameters=accounts:last_login_time
&filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z

関係演算子には次のものがあります。

  • == - 「次と等しい」。
  • <> - 「等しくない」。URL エンコードされています（%3C%3E）。
  • < - 「より小さい」。URL エンコードされている（%3C）。
  • <= - 「次の値以下」。URL エンコードされています（%3C=）。
  • > - 「次の値より大きい」。URL エンコードされています（%3E）。
  • >= - 「次の値以上」。URL エンコードされています（%3E=）。
maxResults

integer (uint32 format)

各応答ページに表示するアクティビティ レコードの数を指定します。たとえば、リクエストで maxResults=1 が設定され、レポートに 2 つのアクティビティがある場合、レポートには 2 つのページが含まれます。レスポンスの nextPageToken プロパティに 2 ページ目へのトークンが含まれている。
maxResults クエリ文字列は省略可能です。
orgUnitID

string

レポートの対象となる組織部門の ID。ユーザー アクティビティは、指定した組織部門に所属するユーザーにのみ表示されます。

2018 年 12 月 17 日より前のデータはフィルタ結果に表示されません。
pageToken

string

次のページを指定するためのトークン。複数のページを含むレポートには、レスポンスに nextPageToken プロパティが含まれます。レポートの次のページを取得する後続のリクエストで、pageToken クエリ文字列に nextPageToken 値を入力します。
parameters

string

parameters クエリ文字列は、レポートの結果を絞り込むイベント パラメータのカンマ区切りのリストです。パラメータは特定のアプリケーションに関連付けられています。顧客使用状況レポートのアプリケーション値には、accounts、app_maker、apps_scripts、calendar、classroom、cros、docs、gmail、gplus、device_management、meet、sites があります。
parameters クエリ文字列は app_name1:param_name1, app_name2:param_name2 の CSV 形式です。
groupIdFilter

string

ユーザー アクティビティがフィルタされる、カンマ区切りのグループ ID（難読化）。つまり、レスポンスには、ここに記載されているグループ ID の少なくとも 1 つに含まれるユーザーのアクティビティのみが含まれます。形式: "id:abc123,id:xyz456"

リクエスト本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功した場合、レスポンスの本文には UsageReports のインスタンスが含まれます。

認可スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/admin.reports.usage.readonly

詳細については、承認ガイドをご覧ください。