Извлекает отчет, который представляет собой набор свойств и статистики для учетной записи конкретного клиента. Для получения дополнительной информации см. руководство Customers Usage Report . Для получения дополнительной информации о параметрах отчета клиента см. справочные руководства Customers Usage Parameters .
HTTP-запрос
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/{date}
Представляет дату использования, основанную на UTC-8:00 (тихоокеанское стандартное время). Временная метка имеет формат ISO 8601 , yyyy-mm-dd .
Параметры запроса
Параметры
customerId
string
Уникальный идентификатор клиента, для которого необходимо получить данные.
pageToken
string
Токен для указания следующей страницы. Отчет с несколькими страницами имеет свойство nextPageToken в ответе. Для последующих запросов, получающих все страницы отчета, введите значение nextPageToken в строку запроса pageToken .
parameters
string
Строка запроса parameters — это разделенный запятыми список параметров событий, которые уточняют результаты отчета. Параметр связан с определенным приложением. Значения приложения для отчета об использовании Customers включают accounts , app_maker , apps_scripts , calendar , chat , classroom , cros , docs , gmail , gplus , device_management , meet и sites . Строка запроса parameters имеет формат CSV app_name1:param_name1, app_name2:param_name2 .
Текст запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит экземпляр UsageReports .
[null,null,["Последнее обновление: 2025-06-26 UTC."],[],[],null,["# Method: customerUsageReports.get\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nRetrieves 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](/admin-sdk/reports/v1/guides/manage-usage-customers). For more information about the customer report's parameters, see the [Customers Usage parameters](/admin-sdk/reports/v1/reference/usage-ref-appendix-a/customers) reference guides. \n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/reports/v1/usage/dates/{date}`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `date` | `string` Represents the date the usage occurred, based on UTC-8:00 (Pacific Standard Time). The timestamp is in the [ISO 8601 format](https://en.wikipedia.org/wiki/ISO_8601), `yyyy-mm-dd`. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customerId` | `string` The unique ID of the customer to retrieve data for. |\n| `pageToken` | `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. |\n| `parameters` | `string` The `parameters` query string is a comma-separated list of event parameters that refine a report's results. The parameter is associated with a specific application. The application values for the Customers usage report include `accounts`, `app_maker`, `apps_scripts`, `calendar`, `chat`, `classroom`, `cros`, `docs`, `gmail`, `gplus`, `device_management`, `meet`, and `sites`. A `parameters` query string is in the CSV form of `app_name1:param_name1, app_name2:param_name2`. | **Note:** The API doesn't accept multiple values of a parameter. If a particular parameter is supplied more than once in the API request, the API only accepts the last value of that request parameter. | In addition, if an invalid request parameter is supplied in the API request, the API ignores that request parameter and returns the response corresponding to the remaining valid request parameters. | An example of an invalid request parameter is one that does not belong to the application. If no parameters are requested, all parameters are returned. \u003cbr /\u003e |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains an instance of [UsageReports](/workspace/admin/reports/reference/rest/v1/customerUsageReports#UsageReports).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admin.reports.usage.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
