The Customers usage report returns G Suite service activities within your account. These reports can be customized and filtered for specific usage information. The maximum time period for each report is the last 180 days. For more information, see the Customers Usage Report guide.
For a list of methods for this resource, see the end of this page.
Resource representations
{ "kind": "admin#reports#usageReports", "warnings": [ { "code": string, "message": string, "data": [ { "key": string, "value": string } ] } ], "nextPageToken": string, "usageReports": [ { "kind": "admin#reports#usageReport", "date": string, "entity": { "type": string, "customerId": string }, "parameters": [ { "name": string, "stringValue": string, "datetimeValue": datetime, "intValue": long, "boolValue": boolean } ] } ] }
Property name | Value | Description | Notes |
---|---|---|---|
kind |
string |
The type of API resource. For a usage report, the value is admin#reports#usageReports . |
|
warnings[] |
list |
Warnings, if any. | |
warnings[].code |
string |
Machine readable code or warning type. The warning code value is 200 .
Acceptable values are:
|
|
warnings[].message |
string |
The human readable messages for a warning are:
|
|
warnings[].data[] |
list |
Key-value pairs to give detailed information on the warning. | |
warnings[].data[].key |
string |
Key associated with a key-value pair to give detailed information on the warning. | |
warnings[].data[].value |
string |
Value associated with a key-value pair to give detailed information on the warning. | |
nextPageToken |
string |
Token to specify next page. A report with multiple pages has a nextPageToken property in the response. For your follow-on requests getting all of the report's pages, enter the nextPageToken value in the pageToken query string. |
|
usageReports[] |
list |
Various application parameter records. | |
usageReports[].kind |
string |
The type of API resource. For a usage report, the value is admin#reports#usageReport . |
|
usageReports[].date |
string |
The date of the report request. | |
usageReports[].entity |
object |
Information about the type of the item. | |
usageReports[].entity.type |
string |
The type of item. The value is customer . |
|
usageReports[].entity.customerId |
string |
The unique identifier of the customer's account. | |
usageReports[].parameters[] |
list |
Parameter value pairs for various applications. For the Customers Usage Report parameters and values, see the Customers Usage parameters reference. | |
usageReports[].parameters[].name |
string |
The name of the parameter. For the Customers Usage Report parameter names, see the Customer Usage parameters reference. | |
usageReports[].parameters[].stringValue |
string |
String value of the parameter. | |
usageReports[].parameters[].datetimeValue |
datetime |
The RFC 3339 formatted value of the parameter, for example 2010-10-28T10:26:35.000Z . |
|
usageReports[].parameters[].intValue |
long |
Integer value of the parameter. | |
usageReports[].parameters[].boolValue |
boolean |
Boolean value of the parameter. |
Methods
- get
- Retrieves a report which is a collection of properties and statistics for a specific customer's account. For more information, see the Customers Usage Report guide. For more information about the customer report's parameters, see the Customers Usage parameters reference guides.