Ruft einen Bericht ab, der eine Sammlung von Properties und Statistiken für eine Gruppe von Nutzern mit dem Konto enthält. Weitere Informationen finden Sie im Leitfaden zur Nutzernutzung. Weitere Informationen zu den Parametern des Nutzerberichts finden Sie in den Referenzleitfäden der Parameter zur Nutzernutzung.
HTTP-Anfrage
GET https://admin.googleapis.com/admin/reports/v1/usage/users/{userKey or all}/dates/{date}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
userKey or all |
Die Profil-ID oder die Nutzer-E-Mail-Adresse, für die die Daten gefiltert werden sollen. Kann |
date |
Das Datum, an dem die Nutzung stattgefunden hat, basierend auf UTC-8:00 (Pacific Standard Time). Der Zeitstempel hat das ISO 8601-Format: |
Abfrageparameter
Parameter | |
---|---|
customerId |
Die eindeutige ID des Kunden, für den Daten abgerufen werden sollen. |
filters |
Der Abfragestring Filter haben das Format In diesem Beispiel ist der GET https://www.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time &filters=accounts:last_login_time%3C%3E2010-10-28T10:26:35.000Z Zu den relationalen Operatoren gehören:
|
maxResults |
Legt fest, wie viele Aktivitätsdatensätze auf jeder Antwortseite angezeigt werden. Wenn in der Anfrage beispielsweise |
orgUnitID |
ID der Organisationseinheit, für die der Bericht erstellt werden soll. Nutzeraktivitäten werden nur für Nutzer angezeigt, die zur angegebenen Organisationseinheit gehören. |
pageToken |
Token zur Angabe der nächsten Seite. Ein Bericht mit mehreren Seiten enthält die Property |
parameters |
Der Abfragestring |
groupIdFilter |
Kommagetrennte Gruppen-IDs (verschleiert), nach denen Nutzeraktivitäten gefiltert werden, d.h. die Antwort enthält nur Aktivitäten für diejenigen Nutzer, die zu mindestens einer der hier genannten Gruppen-IDs gehören. Format: „id:abc123,id:xyz456“ |
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.