Method: customerUsageReports.get

• HTTP-Anfrage
• Pfadparameter
• Anfrageparameter
• Anfragetext
• Antworttext
• Autorisierungsbereiche
• Testen!

Ruft einen Bericht ab, der eine Sammlung von Properties und Statistiken für ein bestimmtes Kundenkonto enthält. Weitere Informationen finden Sie im Bericht zur Kundennutzung. Weitere Informationen zu den Parametern des Kundenberichts finden Sie in den Referenzleitfäden der Kundennutzungsparameter.

HTTP-Anfrage

GET https://admin.googleapis.com/admin/reports/v1/usage/dates/{date}

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
date	string Das Datum, an dem die Nutzung stattgefunden hat, basierend auf UTC-8:00 (Pacific Standard Time). Der Zeitstempel hat das ISO 8601-Format: yyyy-mm-dd.

Abfrageparameter

Parameter
customerId	string Die eindeutige ID des Kunden, für den Daten abgerufen werden sollen.
pageToken	string Token zur Angabe der nächsten Seite. Ein Bericht mit mehreren Seiten enthält die Property nextPageToken in der Antwort. Geben Sie für Ihre Folgeanfragen, die alle Seiten des Berichts abrufen, den Wert nextPageToken in den Abfragestring pageToken ein.
parameters	string Der Abfragestring parameters ist eine durch Kommas getrennte Liste von Ereignisparametern, mit denen die Ergebnisse eines Berichts optimiert werden können. Der Parameter ist einer bestimmten Anwendung zugeordnet. Die Anwendungswerte für den Kundennutzungsbericht umfassen accounts, app_maker, apps_scripts, calendar, classroom, cros, docs, gmail, gplus, device_management, meet und sites. Ein parameters-Abfragestring hat das CSV-Format app_name1:param_name1, app_name2:param_name2. Hinweis:Die API akzeptiert nicht mehrere Werte eines Parameters. Wird ein bestimmter Parameter in der API-Anfrage mehrmals angegeben, akzeptiert die API nur den letzten Wert dieses Anfrageparameters. Falls in der API-Anfrage ein ungültiger Anfrageparameter angegeben wird, ignoriert das API diesen Anfrageparameter und gibt die Antwort zurück, die den verbleibenden gültigen Anfrageparametern entspricht. Ein Beispiel für einen ungültigen Anfrageparameter ist ein Anfrageparameter, der nicht zur Anwendung gehört. Werden keine Parameter angefordert, werden alle Parameter zurückgegeben.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von UsageReports.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.