Method: customerUsageReports.get

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 "Utilisation par les 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}

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
date

string

Représente la date d'utilisation, sur la base de 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 récupérer les données.

pageToken

string

Jeton pour spécifier la page suivante. Un rapport comportant plusieurs pages comporte une propriété nextPageToken dans la réponse. Pour vos requêtes ultérieures obtenant 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, classroom, cros, docs, gmail, gplus, device_management, meet et sites.
Une chaîne de requête parameters se présente au format CSV de 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.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/admin.reports.usage.readonly

Pour en savoir plus, consultez le guide d'autorisation.