顧客使用状況レポートでは、ドメイン全体のすべてのユーザーの Google Workspace サービスの使用状況情報が集計されます。ユーザー使用状況レポートでは、アカウント全体の Google Workspace サービスの使用状況に関する情報が返されます。この使用情報は、アプリケーション固有のパラメータで構成されるアプリケーション タイプごとに整理されています。各レポートのデフォルトおよび最大期間は過去 450 日間です。
これらの使用状況レポートは、顧客契約に従い、合法的な目的にのみ使用することができます。また、これらのレポートは Google Workspace と Google for Education にも適用されます。
顧客使用状況レポートを取得する
アカウント アクティビティのレポートを取得するには、次の GET HTTP リクエストを使用し、承認のドキュメントで説明されている認証トークンを含めます。次の例では、読みやすくするために改行を挿入しています。
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/yyyy-mm-dd date ?parameters=app name: usage parameter,... &customerId=the customer's ID &maxResults=number of events listed on each page of the report
dates 値は使用が発生した日付で、タイムスタンプは ISO 8601 形式（yyyy-mm-dd）です。これには、アカウントのタイムゾーンを使用することをおすすめします。リクエストのクエリ文字列とレスポンス プロパティの詳細については、API リファレンスと顧客使用状況レポートのパラメータ リファレンスをご覧ください。
次の例では、過去 30 日間に成功したアカウントへの全ログインの合計数と、承認済みアプリケーションのリスト（2013 年 3 月 3 日以降のアプリケーションごとのユーザー承認数を含む）のレポートを取得します。maxResults クエリ文字列は、このレポートがレポートページごとに 2 つのイベントを返すことを示しています。
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/2013-03-03 ?parameters=accounts:num_30day_logins%2Caccounts:authorized_apps&maxResults=2
お客様使用状況レポートの JSON レスポンス
{
"kind": "reports#usageReports",
"warnings": [
{
"code": warning machine-readable code,
"message": warning human-readable message,
"data": [
{
"key": key for key-value pair that gives detailed warning information,
"value": value for key-value pair giving detailed warning information
}
]
}
],
"nextPageToken": "N:NNN:NNN:N:C03az79cb",
"usageReports": [
{
"kind": "usageReport",
"date": "2013-03-03",
"entity": {
"type": "CUSTOMER",
"customerId": "C03az79cb"
},
"parameters": [
{
"name": "accounts:num_1day_logins",
"intValue": "1"
},
{
"name": "accounts:num_30day_logins",
"intValue": "1"
},
{
"name": "accounts:num_7day_logins",
"intValue": "1"
},
{
"name": "accounts:num_disabled_accounts",
"intValue": "5"
},
{
"name": "accounts:authorized_apps",
"msgValue": [
{
"client_id": "1234.apps.googleusercontent.com",
"client_name": "www.example.com",
"num_users": 2
},
{
"client_id": "4567.apps.googleusercontent.com",
"client_name": "Example",
"num_users": 1
},
...
]
}
]
}
]
}