フィードバックを送信
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、chat、docs、gmail があります。
フィルタの形式は [application name]:[parameter
name][relational operator][parameter value],... です。
この例では、<>「不等」演算子は、リクエストのクエリ文字列で URL エンコードされています(%3C%3E)。
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、chat、classroom、cros、docs、gmail、gplus、device_management、meet、sites があります。 parameters クエリ文字列は、app_name1:param_name1, app_name2:param_name2 の CSV 形式です。
注: この API では、パラメータの複数の値を指定できません。API リクエストで特定のパラメータが複数回指定された場合、API はリクエスト パラメータの最後の値のみを受け入れます。また、API リクエストで無効なリクエスト パラメータが指定された場合、API はそのリクエスト パラメータを無視し、残りの有効なリクエスト パラメータに対応するレスポンスを返します。
無効なリクエスト パラメータの例としては、アプリケーションに属していないパラメータがあります。パラメータがリクエストされていない場合は、すべてのパラメータが返されます。
groupIdFilter
string
ユーザー アクティビティがフィルタされるグループ ID(難読化)をカンマ区切りで指定します。レスポンスには、ここで指定したグループ ID の少なくとも 1 つに属するユーザーのアクティビティのみが含まれます。形式: "id:abc123,id:xyz456"
リクエストの本文
リクエストの本文は空にする必要があります。
レスポンスの本文
成功した場合、レスポンスの本文には UsageReports のインスタンスが含まれます。
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/admin.reports.usage.readonly
詳しくは、認可ガイド をご覧ください。
フィードバックを送信
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンス により使用許諾されます。コードサンプルは Apache 2.0 ライセンス により使用許諾されます。詳しくは、Google Developers サイトのポリシー をご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-06-26 UTC。
ご意見をお聞かせください
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-06-26 UTC。"],[],[]]