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 sur les rapports sur l'utilisation des clients. Pour plus d'informations sur les paramètres du rapport client, consultez les guides de référence 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 à laquelle l'utilisation a eu lieu, basée sur UTC-8:00 (heure normale du Pacifique). L'horodatage est au format ISO 8601 : yyyy-mm-dd.

Paramètres de requête

Paramètres
customerId

string

Identifiant unique du client pour lequel les données doivent être récupérées.

pageToken

string

Jeton permettant de spécifier la page suivante. Un rapport comportant plusieurs pages comporte une propriété nextPageToken dans la réponse. Pour que les demandes ultérieures obtiennent 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 une virgule qui affinent les résultats d'un rapport. Le paramètre est associé à une application spécifique. Les valeurs correspondant aux applications dans le rapport sur l'utilisation des clients sont les suivantes : 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 : 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 relatif aux autorisations.