Method: customerUsageReports.get

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

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. 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. Wenn in der API-Anfrage ein ungültiger Anfrageparameter angegeben wird, ignoriert die 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 Parameter, der nicht zur Anwendung gehört. Wenn keine Parameter angefordert werden, 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.