Method: userUsageReport.get

string

Die Profil-ID oder die E-Mail-Adresse des Nutzers, nach dem die Daten gefiltert werden sollen. Kann all für alle Informationen oder userKey für die eindeutige Google Workspace-Profil-ID eines Nutzers oder seine primäre E-Mail-Adresse sein. Darf kein gelöschter Nutzer sein. Rufen Sie für einen gelöschten Nutzer users.list in der Directory API mit showDeleted=true auf und verwenden Sie dann den zurückgegebenen ID als userKey.

string

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

string

Die eindeutige ID des Kunden, für den Daten abgerufen werden sollen.

string

Der Abfragestring filters ist eine durch Kommas getrennte Liste der Ereignisparameter einer Anwendung, bei der der Wert des Parameters durch einen relationalen Operator geändert wird. Der Abfragestring filters enthält den Namen der Anwendung, deren Nutzung im Bericht zurückgegeben wird. Die Anwendungswerte für den Nutzungsbericht für Nutzer umfassen accounts, docs und gmail.

Filter haben das Format [application name]:[parameter name][relational operator][parameter value],....

In diesem Beispiel hat der <>-Wert „not equal to“ ist im Abfragestring der Anfrage (%3C%3E) URL-codiert:

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:

• == – "gleich".
• <> – „ungleich“. Sie ist URL-codiert (%3C%3E).
• < – „kleiner als“. Sie ist URL-codiert (%3C).
• <= – „kleiner als oder gleich“. Sie ist URL-codiert (%3C=).
• > – „größer als“. Sie ist URL-codiert (%3E).
• >= – „größer als oder gleich“. Sie ist URL-codiert (%3E=).

integer (uint32 format)

Legt fest, wie viele Aktivitätsdatensätze auf jeder Antwortseite angezeigt werden. Wenn in der Anfrage beispielsweise maxResults=1 festgelegt wird und der Bericht zwei Aktivitäten enthält, umfasst er zwei Seiten. Das Attribut nextPageToken der Antwort enthält das Token für die zweite Seite.
Der Abfragestring maxResults ist optional.

string

ID der Organisationseinheit, für die der Bericht erstellt werden soll. Die Nutzeraktivität wird nur für Nutzer angezeigt, die zur angegebenen Organisationseinheit gehören.

string

Token zum Angeben der nächsten Seite. Ein Bericht mit mehreren Seiten hat die Property nextPageToken in der Antwort. Geben Sie in Ihrer Folgeanfrage zum Abrufen der nächsten Seite des Berichts den Wert nextPageToken in den Abfragestring pageToken ein.

string

Der Abfragestring „parameters“ ist eine durch Kommas getrennte Liste von Ereignisparametern, mit denen die Ergebnisse eines Berichts optimiert werden. Der Parameter ist einer bestimmten Anwendung zugeordnet. Die Anwendungswerte für den Bericht zur Kundennutzung 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.

string

Kommagetrennte Gruppen-IDs (verschleiert), nach denen Nutzeraktivitäten gefiltert werden. Das heißt, die Antwort enthält nur Aktivitäten für die Nutzer, die zu mindestens einer der hier genannten Gruppen-IDs gehören. Format: „id:abc123,id:xyz456“