- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ApplicationName
- Aktivität
- Testen!
Ruft eine Liste der Aktivitäten für das Konto und die Anwendung eines bestimmten Kunden ab, z. B. die Anwendung in der Admin-Konsole oder die Anwendung für Google Drive. Weitere Informationen finden Sie im Handbuch für Administrator- und Google Drive-Aktivitätsberichte. Weitere Informationen zu den Parametern des Aktivitätsberichts finden Sie in den Referenzleitfäden zu Aktivitätsparametern.
HTTP-Anfrage
GET https://admin.googleapis.com/admin/reports/v1/activity/users/{userKey or all}/applications/{applicationName}
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameters | |
---|---|
userKey or all |
Die Profil-ID oder die E-Mail-Adresse des Nutzers, für die die Daten gefiltert werden sollen. Kann |
applicationName |
Name der Anwendung, für die die Ereignisse abgerufen werden sollen. |
Abfrageparameter
Parameters | |
---|---|
actorIpAddress |
Die Internet Protocol-Adresse (IP-Adresse) des Hosts, auf dem das Ereignis stattgefunden hat. Dies ist eine zusätzliche Möglichkeit, die Zusammenfassung eines Berichts nach der IP-Adresse des Nutzers zu filtern, dessen Aktivität gemeldet wird. Diese IP-Adresse kann den physischen Standort des Nutzers widerspiegeln. Beispielsweise kann die IP-Adresse die Adresse des Proxyservers des Nutzers oder die Adresse eines virtuellen privaten Netzwerks (VPN) sein. Dieser Parameter unterstützt sowohl IPv4- als auch IPv6-Adressversionen. |
customerId |
Die eindeutige ID des Kunden, für den Daten abgerufen werden sollen. |
endTime |
Legt das Ende des im Bericht angezeigten Zeitraums fest. Das Datum hat das RFC 3339-Format, z. B. 2010-10-28T10:26:35.000Z. Der Standardwert ist die ungefähre Zeit der API-Anfrage. Ein API-Bericht umfasst drei grundlegende Zeitkonzepte:
endTime nicht angegeben ist, enthält der Bericht alle Aktivitäten vom startTime bis zur aktuellen Uhrzeit oder zu den letzten 180 Tagen, wenn die startTime mehr als 180 Tage in der Vergangenheit liegt.
|
eventName |
Der Name des Ereignisses, das von der API abgefragt wird. Jedes |
filters |
Der Abfragestring Diese Ereignisparameter sind einem bestimmten In den folgenden Drive-Aktivitätsbeispielen enthält die zurückgegebene Liste alle
Eine
Hinweis: Die API akzeptiert nicht mehrere Werte desselben Parameters. Wird ein Parameter in der API-Anfrage mehrmals angegeben, akzeptiert die API nur den letzten Wert des Parameters. Wird in der API-Anfrage ein ungültiger Parameter angegeben, ignoriert die API diesen Parameter und gibt die Antwort zurück, die den verbleibenden gültigen Parametern entspricht. Werden keine Parameter angefordert, werden alle Parameter zurückgegeben. |
maxResults |
Legt fest, wie viele Aktivitätsdatensätze auf jeder Antwortseite angezeigt werden. Wenn die Anfrage beispielsweise |
orgUnitID |
ID der Organisationseinheit, für die der Bericht erstellt werden soll. Aktivitätseinträge werden nur für Nutzer angezeigt, die zur angegebenen Organisationseinheit gehören. |
pageToken |
Das Token, das die nächste Seite angeben soll. Ein Bericht mit mehreren Seiten enthält die Property |
startTime |
Legt den Beginn des Zeitraums fest, der im Bericht angezeigt wird. Das Datum hat das RFC 3339-Format, z. B. 2010-10-28T10:26:35.000Z. Der Bericht enthält alle Aktivitäten vom |
groupIdFilter |
Kommagetrennte Gruppen-IDs (verschleiert), nach denen Nutzeraktivitäten gefiltert werden, d.h., 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“ |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
JSON-Vorlage für eine Sammlung von Aktivitäten.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"kind": string,
"etag": string,
"items": [
{
object ( |
Felder | |
---|---|
kind |
Der Typ der API-Ressource. Bei einem Aktivitätsbericht lautet der Wert |
etag |
Das ETag der Ressource. |
items[] |
Jede Aktivität wird in der Antwort aufgezeichnet. |
nextPageToken |
Token zum Abrufen der nächsten Seite des Berichts. Der Wert |
Autorisierungsbereiche
Erfordert den folgenden OAuth-Bereich:
https://www.googleapis.com/auth/admin.reports.audit.readonly
Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
ApplicationName
Enums | |
---|---|
access_transparency |
Die Access Transparency-Aktivitätsberichte für Google Workspace enthalten Informationen zu verschiedenen Arten von Access Transparency-Aktivitätsereignissen. |
admin |
In den Aktivitätsberichten der Admin-Konsole werden Kontoinformationen zu verschiedenen Arten von Administratoraktivitätsereignissen zurückgegeben. |
calendar |
Die Aktivitätsberichte der Google Kalender-Anwendung enthalten Informationen zu verschiedenen Kalenderaktivitätsereignissen. |
chat |
Die Berichte zur Chataktivität enthalten Informationen zu verschiedenen Ereignissen der Chataktivität. |
drive |
Die Aktivitätsberichte der Google Drive-Anwendung enthalten Informationen zu verschiedenen Google Drive-Aktivitätsereignissen. Der Aktivitätsbericht in Drive ist nur für Kunden von Google Workspace Business und Google Workspace Enterprise verfügbar. |
gcp |
Die Aktivitätsberichte der Google Cloud Platform-Anwendung enthalten Informationen zu verschiedenen GCP-Aktivitätsereignissen. |
gplus |
Die Aktivitätsberichte der Google+ App enthalten Informationen zu verschiedenen Google+ Aktivitätsereignissen. |
groups |
Die Aktivitätsberichte der Google Groups App enthalten Informationen zu verschiedenen Google Groups-Aktivitätsereignissen. |
groups_enterprise |
Die Aktivitätsberichte zu Unternehmensgruppen enthalten Informationen zu verschiedenen Aktivitäten von Unternehmensgruppen. |
jamboard |
Die Jamboard-Aktivitätsberichte enthalten Informationen zu verschiedenen Jamboard-Aktivitätsereignissen. |
login |
In den Aktivitätsberichten der Anmeldeanwendung werden Kontoinformationen zu verschiedenen Arten von Ereignissen der Anmeldeaktivität zurückgegeben. |
meet |
Dieser enthält Informationen zu den verschiedenen Arten von Meet-Audit-Aktivitätsereignissen. |
mobile |
Dieser Bericht enthält Informationen zu verschiedenen Arten von Aktivitätsereignissen der Geräteprüfung. |
rules |
Der Bericht zur Regelaktivität enthält Informationen zu verschiedenen Arten von Aktivitätsereignissen für Regeln. |
saml |
Der SAML-Aktivitätsbericht enthält Informationen zu verschiedenen Arten von SAML-Aktivitätsereignissen. |
token |
Die Aktivitätsberichte der Token-Anwendung geben Kontoinformationen zu verschiedenen Arten von Token-Aktivitätsereignissen zurück. |
user_accounts |
Die Aktivitätsberichte der Nutzerkonten-Anwendung geben Kontoinformationen zu verschiedenen Arten von Aktivitätsereignissen der Nutzerkonten zurück. |
context_aware_access |
Die Berichte zu Aktivitäten für den kontextsensitiven Zugriff enthalten Informationen zu Ereignissen, die Nutzern aufgrund von Regeln für den kontextsensitiven Zugriff den Zugriff verweigert haben. |
chrome |
Die Chrome-Aktivitätsberichte enthalten Informationen zu Chrome-Browser und Chrome OS-Ereignissen. |
data_studio |
Die Data Studio-Aktivitätsberichte enthalten Informationen zu verschiedenen Data Studio-Aktivitätsereignissen. |
keep |
Die Aktivitätsberichte der Google Notizen App enthalten Informationen zu verschiedenen Aktivitätsereignissen von Google Notizen. Der Bericht „Aktivitäten in Google Notizen“ ist nur für Kunden von Google Workspace Business und Google Workspace Enterprise verfügbar. |
vault |
Die Vault-Aktivitätsberichte enthalten Informationen zu verschiedenen Arten von Vault-Aktivitätsereignissen. |
Aktivität
JSON-Vorlage für die Aktivitätsressource.
JSON-Darstellung |
---|
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object ( |
Felder | |
---|---|
kind |
Der Typ der API-Ressource. Bei einem Aktivitätsbericht lautet der Wert |
etag |
Das ETag des Eintrags. |
ownerDomain |
Dies ist die Domain, die vom Ereignis im Bericht betroffen ist. z. B. die Domain der Admin-Konsole oder der Eigentümer des Dokuments der Drive-Anwendung. |
ipAddress |
IP-Adresse des Nutzers, der die Aktion ausführt. Dies ist die IP-Adresse (Internet Protocol) des Nutzers bei der Anmeldung in Google Workspace, die den physischen Standort des Nutzers widerspiegeln kann oder nicht. Beispielsweise kann die IP-Adresse die Adresse des Proxyservers des Nutzers oder die Adresse eines virtuellen privaten Netzwerks (VPN) sein. Die API unterstützt IPv4 und IPv6. |
events[] |
Aktivitätsereignisse im Bericht. |
events[].type |
Ereignistyp. Der Google Workspace-Dienst oder die Google Workspace-Funktion, den bzw. die ein Administrator ändert, wird in der Property „ |
events[].name |
Name des Ereignisses. Dies ist der spezifische Name der Aktivität, die von der API gemeldet wird. Und jede
Weitere Informationen zu eventName -Eigenschaften finden Sie oben in der Liste der Ereignisnamen für verschiedene Anwendungen unter applicationName .
|
events[].parameters[] |
Parameterwertpaare für verschiedene Anwendungen. Weitere Informationen zu |
events[].parameters[].messageValue |
Verschachtelte Parameterwertpaare, die diesem Parameter zugeordnet sind. Der komplexe Werttyp für einen Parameter wird als Liste von Parameterwerten zurückgegeben. Der Adressparameter kann beispielsweise den Wert |
events[].parameters[].messageValue.parameter[] |
Parameterwerte |
events[].parameters[].name |
Name des Parameters. |
events[].parameters[].value |
Stringwert des Parameters. |
events[].parameters[].multiValue[] |
Stringwerte des Parameters. |
events[].parameters[].intValue |
Ganzzahlwert des Parameters. |
events[].parameters[].multiIntValue[] |
Ganzzahlwerte des Parameters. |
events[].parameters[].boolValue |
Boolescher Wert des Parameters. |
events[].parameters[].multiMessageValue[] |
Aktivitäten.list mit |
events[].parameters[].multiMessageValue[].parameter[] |
Parameterwerte |
id |
Eindeutige Kennung für jeden Aktivitätsdatensatz. |
id.time |
Zeitpunkt des Auftretens der Aktivität. Die Angabe erfolgt in Sekunden der UNIX-Epoche. |
id.uniqueQualifier |
Eindeutiger Qualifier, wenn mehrere Ereignisse dieselbe Zeit haben. |
id.applicationName |
Name der Anwendung, zu der das Ereignis gehört. Mögliche Werte finden Sie in der Liste der Anwendungen oben unter |
id.customerId |
Die eindeutige Kennung für ein Google Workspace-Konto. |
actor |
Nutzer, der die Aktion ausführt |
actor.profileId |
Die eindeutige Google Workspace-Profil-ID des Akteurs. Dieser Wert fehlt möglicherweise, wenn der Akteur kein Google Workspace-Nutzer ist, oder die Nummer 105250506097979753968, die als Platzhalter-ID dient. |
actor.email |
Die primäre E-Mail-Adresse des Akteurs. Kann möglicherweise fehlen, wenn keine E-Mail-Adresse mit dem Schauspieler verknüpft ist. |
actor.callerType |
Der Typ des Schauspielers. |
actor.key |
Nur vorhanden, wenn |