Ruft einen Bericht ab, der eine Sammlung von Eigenschaften und Statistiken für Entitäten enthält, die von Nutzern im Konto verwendet werden. Weitere Informationen finden Sie im Leitfaden zur Entitätsnutzung. Weitere Informationen zu den Parametern des Entitätsberichts finden Sie in den Referenzleitfäden unter Parameter zur Entitätsnutzung.
HTTP-Anfrage
GET https://admin.googleapis.com/admin/reports/v1/usage/{entityType}/{entityKey or all}/dates/{date}
Stellt den Schlüssel des Objekts dar, mit dem die Daten gefiltert werden sollen. Es ist ein String, der den Wert all annehmen kann, um Aktivitätsereignisse für alle Nutzer oder einen beliebigen anderen Wert für eine App-spezifische Entität abzurufen. Weitere Informationen zum Abrufen der entityKey für eine bestimmte entityType finden Sie in den Referenzleitfäden zur Verwendung der Parameter für Entitäten.
date
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.
Abfrageparameter
Parameter
customerId
string
Die eindeutige ID des Kunden, für den Daten abgerufen werden sollen.
filters
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 Bericht zur Entitätsnutzung 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/gplus_communities/all/dates/2017-12-01
?parameters=gplus:community_name,gplus:num_total_members
&filters=gplus:num_total_members%3C%3E0
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=).
Filter können nur auf numerische Parameter angewendet werden.
Legt fest, wie viele Aktivitätsdatensätze auf jeder Antwortseite angezeigt werden. Wenn in der Anfrage beispielsweise <span>maxResults=1</span> festgelegt wird und der Bericht zwei Aktivitäten enthält, umfasst er zwei Seiten. Das Attribut <span>nextPageToken</span> der Antwort enthält das Token für die zweite Seite.
pageToken
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.
parameters
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 Entitätsnutzung sind nur gplus. Ein parameter-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.