Im Bericht zur Nutzernutzung finden Sie Informationen zur Nutzung des Google Workspace-Dienstes für einen bestimmten Nutzer in Ihrer Domain. Diese Berichte können angepasst und nach bestimmten Nutzungsinformationen gefiltert werden. Der Standard- und der maximale Zeitraum für jeden Bericht sind die letzten 450 Tage.
Der Nutzungsbericht darf nur gemäß Ihrer Kundenvereinbarung nur für rechtmäßige Zwecke verwendet werden. Diese Berichte gelten auch für Google Workspace und Google Workspace for Education.
Alle Nutzernutzungsaktivitäten abrufen
Wenn Sie einen Bericht über alle Nutzeraktivitäten in Ihrem Konto abrufen möchten, verwenden Sie die folgende GET-HTTP-Anfrage und fügen Sie das in der Autorisierungsdokumentation beschriebene Autorisierungstoken ein. Zur besseren Lesbarkeit ist das folgende Beispiel mit Zeilenumbrüchen formatiert:
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/yyyy-mm-dd date ?parameters=application: user usage parameter,... &filters=application: user usage parameter relational operator usage parameter's value,... &maxResults=number of events listed on each page of the report
Der Wert dates gibt das Datum der Nutzung an und der Zeitstempel hat das ISO 8601-Format, jjjj-mm-tt. Wir empfehlen, hierfür die Zeitzone Ihres Kontos zu verwenden. Weitere Informationen zu den Abfragestringparametern und -eigenschaften finden Sie in der API-Referenz. Informationen zu den Parametern des Berichts zur Nutzernutzung finden Sie in der Referenz zu Parametern für die Nutzernutzung.
Im folgenden Beispiel erhalten Sie einen Bericht zu allen Nutzeraktivitäten für das Konto.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?maxResults=2
Im folgenden Beispiel werden Berichte zu allen Nutzeraktivitäten für ein bestimmtes Kundenkonto abgerufen.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all /dates/2013-03-03?customerId=C03az79cb
Im folgenden Beispiel werden Berichte zu den Zeitstempeln der letzten Anmeldung der Nutzer im Konto erstellt. Ein Beispiel für eine API-Antwort finden Sie im Beispiel für eine JSON-Antwort.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time&maxResults=2
Im folgenden Beispiel wird ein Bericht zu den Zeitstempeln der letzten Anmeldung der Nutzer im Konto abgerufen und nach Nutzern gefiltert, die sich nach einer bestimmten Zeit angemeldet haben. Ein Beispiel für eine API-Antwort finden Sie im Beispiel für eine JSON-Antwort.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time&filters=accounts:last_login_time >2010-10-28T10:26:35.000Z"
Im folgenden Beispiel werden die Zeitstempel der letzten Anmeldung und der Sperrstatus der Nutzer im Konto abgerufen. Ein Beispiel für eine API-Antwort finden Sie im Beispiel für eine JSON-Antwort.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/all/dates/2013-03-03 ?parameters=accounts:last_login_time,accounts:is_disabled"
Nutzeraktivitäten eines bestimmten Nutzers abrufen
Wenn Sie einen Bericht mit den Aktivitäten eines bestimmten Nutzers in Ihrem Konto abrufen möchten, verwenden Sie die folgende GET-HTTP-Anfrage und fügen Sie das in der Autorisierungsdokumentation beschriebene Autorisierungstoken ein. Zur besseren Lesbarkeit ist das folgende Beispiel mit Zeilenumbrüchen formatiert.
GET https://admin.googleapis.com/admin/reports/v1/usage/users/userKey/dates/yyyy-mm-dd date ?parameters=application: user usage parameter,... &filters=application: user usage parameter relational operator usage parameter's value,... &maxResults=number of events listed on each page of the report
Die userKey kann entweder die primäre E-Mail-Adresse des Nutzers im Bericht oder die eindeutige Google Workspace-profileId des Nutzers sein. Der Wert dates gibt das Datum der Nutzung an und der Zeitstempel hat das ISO 8601-Format, jjjj-mm-tt. Wir empfehlen, hierfür die Zeitzone Ihres Kontos zu verwenden. Weitere Informationen zu den Abfragestringparametern und -eigenschaften finden Sie in der API-Referenz. Informationen zu den Parametern des Berichts zur Nutzernutzung finden Sie in der Referenz zu Parametern für die Nutzernutzung.
Im folgenden Beispiel wird der Nutzungsbericht für max@beispiel.de abgerufen.
https://admin.googleapis.com/admin/reports/v1/usage/users/john@example.com/dates/2013-03-03
JSON-Antwortvorlage für Nutzungsbericht
Eine erfolgreiche Antwort gibt einen HTTP 200-Statuscode zurück. Zusammen mit dem Statuscode gibt die Antwort einen Bericht zurück.
JSON-Antwort für Nutzerbericht
{
"kind": "reports#usageReports",
"warnings": [
{
"code": warning machine-readable code,
"message": warning human-readable message,
"data": [
{
"key": key for key-value pair that gives detailed warning information,
"value": value for key-value pair giving detailed warning information
}
]
}
],
"nextPageToken": "N:NNN:NNN:N:C03az79cb",
"usageReports": [
{
"kind": "usageReport",
"date": "2013-03-03",
"entity": {
"type": "USER",
"customerId": "C03az79cb",
"userEmail": "liz@example.com",
"profileId": "user's unique Google Workspace ID"
},
"parameters": [
{
"name": "accounts:is_disabled",
"boolValue": false
},
{
"name": "accounts:disabled_reason",
"stringValue": "reason description"
},
{
"name": "accounts:first_name",
"stringValue": "Liz"
},
{
"name": "accounts:is_2sv_enforced",
"boolValue": false
},
{
"name": "accounts:is_2sv_enrolled",
"boolValue": false
},
{
"name": "accounts:last_name",
"stringValue": "Smith"
},
{
"name": "accounts:creation_time",
"datetimeValue": "2010-10-28T10:26:35.000Z"
},
{
"name": "accounts:last_login_time",
"datetimeValue": "1970-01-01T00:00:00.000Z"
},
{
"name": "accounts:last_sso_time",
"datetimeValue": "1970-01-01T00:00:00.000Z"
}
]
}
]
}