Method: customerUsageReports.get

Ruft einen Bericht ab, der eine Sammlung von Properties und Statistiken für das Konto eines bestimmten Kunden ist. Weitere Informationen finden Sie im Leitfaden zum Bericht zur Kundennutzung. Weitere Informationen zu den Parametern des Kundenberichts finden Sie in den Referenzhandbüchern zu Nutzungsparametern für Kunden.

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 der Zeitzone UTC-8:00 (Pacific Standard Time). Der Zeitstempel ist im 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 zum Angeben der nächsten Seite. Ein Bericht mit mehreren Seiten enthält in der Antwort die Property nextPageToken. Geben Sie in den nachfolgenden Anfragen, mit denen alle Seiten des Berichts abgerufen werden, 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 in einem Bericht optimiert werden. Der Parameter ist einer bestimmten Anwendung zugeordnet. Zu den Anwendungswerten für den Bericht zur Kundennutzung gehören 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.

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.