Récupère un rapport, qui est un ensemble de propriétés et de statistiques pour le compte d'un client spécifique. Pour en savoir plus, consultez le guide du rapport sur l'utilisation des clients. Pour en savoir plus sur les paramètres du rapport sur les clients, consultez les guides de référence sur les paramètres d'utilisation des clients.
Requête HTTP
GET https://admin.googleapis.com/admin/reports/v1/usage/dates/{date}
Représente la date à laquelle l'utilisation a eu lieu, en fonction de l'heure UTC-8:00 (heure normale du Pacifique). Le code temporel est au format ISO 8601, yyyy-mm-dd.
Paramètres de requête
Paramètres
customerId
string
Identifiant unique du client pour lequel vous souhaitez récupérer des données.
pageToken
string
Jeton permettant de spécifier la page suivante. Un rapport comportant plusieurs pages contient une propriété nextPageToken dans la réponse. Pour vos requêtes ultérieures qui récupèrent toutes les pages du rapport, saisissez la valeur nextPageToken dans la chaîne de requête pageToken.
parameters
string
La chaîne de requête parameters est une liste de paramètres d'événement séparés par des virgules qui affinent les résultats d'un rapport. Le paramètre est associé à une application spécifique. Les valeurs d'application du rapport sur l'utilisation des clients incluent accounts, app_maker, apps_scripts, calendar, chat, classroom, cros, docs, gmail, gplus, device_management, meet et sites. Une chaîne de requête parameters se présente au format CSV sous la forme app_name1:param_name1, app_name2:param_name2.
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient une instance de UsageReports.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/06/26 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
