- HTTP-Anfrage
- Pfadparameter
- Anfrageparameter
- Anfragetext
- Antworttext
- Autorisierungsbereiche
- ApplicationName
- Aktivität
- NetworkInfo
- ResourceDetails
- AppliedLabel
- FieldValue
- TextListValue
- SelectionValue
- SelectionListValue
- UserValue
- UserListValue
- Datum
- Grund
- Testen!
Ruft eine Liste von Aktivitäten für das Konto und die Anwendung eines bestimmten Kunden ab, z. B. für die Admin-Konsolenanwendung oder die Google Drive-Anwendung. Weitere Informationen finden Sie in den Leitfäden zu Administrator- und Google Drive-Aktivitätsberichten. 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
Parameter | |
---|---|
userKey or all |
Stellt die Profil-ID oder die E-Mail-Adresse des Nutzers dar, nach der die Daten gefiltert werden sollen. Kann |
applicationName |
Der Name der Anwendung, für die die Ereignisse abgerufen werden sollen. |
Abfrageparameter
Parameter | |
---|---|
actorIpAddress |
Die IP-Adresse des Hosts, auf dem das Ereignis ausgeführt wurde. So können Sie die Zusammenfassung eines Berichts zusätzlich nach der IP-Adresse des Nutzers filtern, dessen Aktivitäten erfasst werden. Diese IP-Adresse kann den physischen Standort des Nutzers angeben, muss es aber nicht. Die IP-Adresse kann beispielsweise 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 dargestellten Zeitbereichs fest. Das Datum ist im RFC 3339-Format angegeben, z. B. 2010-10-28T10:26:35.000Z. Der Standardwert ist die ungefähre Zeit der API-Anfrage. Ein API-Bericht hat drei grundlegende Zeitkonzepte:
endTime nicht angegeben ist, werden im Bericht alle Aktivitäten ab dem startTime bis zur aktuellen Zeit oder den letzten 180 Tagen zurückgegeben, wenn das startTime mehr als 180 Tage in der Vergangenheit liegt. Bei Gmail-Anfragen müssen startTime und endTime angegeben werden. Der Unterschied darf nicht mehr als 30 Tage betragen.
|
eventName |
Der Name des Ereignisses, das von der API abgefragt wird. Jede |
filters |
Der Abfragestring Diese Ereignisparameter sind einer bestimmten In den folgenden Beispielen für Drive-Aktivitäten besteht die zurückgegebene Liste aus allen
Eine
Hinweis:Die API akzeptiert nicht mehrere Werte desselben Parameters. Wenn ein Parameter in der API-Anfrage mehrmals angegeben wird, akzeptiert die API nur den letzten Wert dieses Parameters. Wenn in der API-Anfrage ein ungültiger Parameter angegeben wird, ignoriert die API diesen Parameter und gibt die Antwort zurück, die den verbleibenden gültigen Parametern entspricht. Wenn keine Parameter angefordert werden, werden alle Parameter zurückgegeben. |
maxResults |
Legt fest, wie viele Aktivitätsdatensätze auf jeder Antwortseite angezeigt werden. Wenn im Antrag beispielsweise |
orgUnitID |
ID der Organisationseinheit, für die ein Bericht erstellt werden soll. Aktivitätsdatensätze werden nur für Nutzer angezeigt, die der angegebenen Organisationseinheit angehören. |
pageToken |
Das Token, mit dem die nächste Seite angegeben wird. Ein Bericht mit mehreren Seiten hat in der Antwort das Attribut |
startTime |
Legt den Beginn des im Bericht angezeigten Zeitbereichs fest. Das Datum ist im RFC 3339-Format angegeben, z. B. 2010-10-28T10:26:35.000Z. Der Bericht enthält alle Aktivitäten vom |
groupIdFilter |
Durch Kommas getrennte Gruppen-IDs (verschleiert), nach denen Nutzeraktivitäten gefiltert werden. Die Antwort enthält also nur Aktivitäten für Nutzer, die mindestens einer der hier genannten Gruppen-IDs angehö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. Für einen Aktivitätsbericht ist der Wert |
etag |
ETag der Ressource. |
items[] |
Jeder Aktivitätsdatensatz in der Antwort. |
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 Autorisierungsleitfaden.
ApplicationName
Enums | |
---|---|
access_transparency |
Die Google Workspace Access Transparency-Aktivitätsberichte enthalten Informationen zu verschiedenen Arten von Access Transparency-Aktivitätsereignissen. |
admin |
Die Aktivitätsberichte der Admin-Konsolenanwendung enthalten Kontoinformationen zu verschiedenen Arten von Administratoraktivitätsereignissen. |
calendar |
Die Aktivitätsberichte der Google Kalender App enthalten Informationen zu verschiedenen Kalenderaktivitäten. |
chat |
Die Berichte zur Chat-Aktivität enthalten Informationen zu verschiedenen Chat-Aktivitätsereignissen. |
drive |
Die Aktivitätsberichte der Google Drive-Anwendung enthalten Informationen zu verschiedenen Google Drive-Aktivitätsereignissen. Der Google Drive-Aktivitätsbericht ist nur für Google Workspace Business- und Enterprise-Kunden verfügbar. |
gcp |
Die Aktivitätsberichte der Google Cloud Platform-Anwendung enthalten Informationen zu verschiedenen GCP-Aktivitätsereignissen. |
gmail |
Die Aktivitätsberichte der Gmail-Anwendung enthalten Informationen zu verschiedenen Gmail-Aktivitätsereignissen. |
gplus |
Die Aktivitätsberichte der Google+ App enthalten Informationen zu verschiedenen Google+ Aktivitätsereignissen. |
groups |
Die Aktivitätsberichte der Google Groups-Anwendung enthalten Informationen zu verschiedenen Groups-Aktivitätsereignissen. |
groups_enterprise |
Die Aktivitätsberichte für Enterprise-Gruppen enthalten Informationen zu verschiedenen Aktivitätsereignissen für Enterprise-Gruppen. |
jamboard |
Die Jamboard-Aktivitätsberichte enthalten Informationen zu verschiedenen Jamboard-Aktivitätsereignissen. |
login |
Die Aktivitätsberichte der Anmeldeanwendung enthalten Kontoinformationen zu verschiedenen Arten von Anmeldeaktivitätsereignissen. |
meet |
Der Aktivitätsbericht „Meet-Audit“ enthält Informationen zu verschiedenen Arten von Meet-Audit-Aktivitätsereignissen. |
mobile |
Der Aktivitätsbericht „Geräte-Audit“ enthält Informationen zu verschiedenen Arten von Geräte-Audit-Aktivitätsereignissen. |
rules |
Der Aktivitätsbericht für Regeln enthält Informationen zu verschiedenen Arten von Regelaktivitätsereignissen. |
saml |
Der SAML-Aktivitätsbericht enthält Informationen zu verschiedenen Arten von SAML-Aktivitätsereignissen. |
token |
Die Aktivitätsberichte der Token-Anwendung enthalten Kontoinformationen zu verschiedenen Arten von Token-Aktivitätsereignissen. |
user_accounts |
Die Aktivitätsberichte der Anwendung „Nutzerkonten“ enthalten Kontoinformationen zu verschiedenen Arten von Aktivitätsereignissen für Nutzerkonten. |
context_aware_access |
Die Aktivitätsberichte zum kontextsensitiven Zugriff enthalten Informationen zu Ereignissen, bei denen der Zugriff von Nutzern aufgrund von Regeln für den kontextsensitiven Zugriff verweigert wurde. |
chrome |
Die Chrome-Aktivitätsberichte enthalten Informationen zu Chrome-Browser- und ChromeOS-Ereignissen. |
data_studio |
Die Data Studio-Aktivitätsberichte enthalten Informationen zu verschiedenen Arten von Data Studio-Aktivitätsereignissen. |
keep |
Die Aktivitätsberichte der Keep App enthalten Informationen zu verschiedenen Google Keep-Aktivitätsereignissen. Der Bericht zu Keep-Aktivitäten ist nur für Google Workspace Business- und Enterprise-Kunden verfügbar. |
vault |
Die Vault-Aktivitätsberichte enthalten Informationen zu verschiedenen Arten von Vault-Aktivitätsereignissen. |
gemini_in_workspace_apps |
Die Aktivitätsberichte für Gemini für Workspace enthalten Informationen zu verschiedenen Arten von Gemini-Aktivitätsereignissen, die von Nutzern in einer Workspace-Anwendung ausgeführt wurden. |
classroom |
Die Classroom-Aktivitätsberichte enthalten Informationen zu verschiedenen Arten von Classroom-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. Für einen Aktivitätsbericht ist der Wert |
etag |
ETag des Eintrags. |
ownerDomain |
Das ist die Domain, die vom Ereignis im Bericht betroffen ist. Zum Beispiel die Domain der Admin-Konsole oder des Dokumentinhabers der Drive-Anwendung. |
ipAddress |
IP-Adresse des Nutzers, der die Aktion ausführt. Dies ist die IP-Adresse des Nutzers bei der Anmeldung in Google Workspace. Sie kann den physischen Standort des Nutzers angeben, muss es aber nicht. Die IP-Adresse kann beispielsweise 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, die ein Administrator ändert, wird in der Property |
events[].name |
Name des Ereignisses. Der spezifische Name der Aktivität, die von der API gemeldet wird. Jede
Weitere Informationen zu eventName -Properties finden Sie oben in applicationName in der Liste der Ereignisnamen für verschiedene Anwendungen.
|
events[].parameters[] |
Parameterwertpaare für verschiedene Anwendungen. Weitere Informationen zu |
events[].parameters[].messageValue |
Verschachtelte Parameterwertpaare, die diesem Parameter zugeordnet sind. Komplexe Werttypen für einen Parameter werden als Liste von Parameterwerten zurückgegeben. Der Parameter „address“ 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[] |
activities.list von |
events[].parameters[].multiMessageValue[].parameter[] |
Parameterwerte |
events[].resourceIds[] |
Ressourcen-IDs, die mit dem Ereignis verknüpft sind. |
id |
Eindeutige Kennung für jeden Aktivitätsdatensatz. |
id.time |
Zeitpunkt des Auftretens der Aktivität. Das ist die UNIX-Epochenzeit in Sekunden. |
id.uniqueQualifier |
Eindeutiger Qualifikator, wenn mehrere Ereignisse zur selben Zeit stattfinden. |
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 ist möglicherweise nicht vorhanden, wenn der Akteur kein Google Workspace-Nutzer ist. Er kann auch die Nummer 105250506097979753968 sein, die als Platzhalter-ID dient. |
actor.email |
Die primäre E-Mail-Adresse des Akteurs. Kann fehlen, wenn dem Akteur keine E‑Mail-Adresse zugeordnet ist. |
actor.callerType |
Der Typ des Akteurs. |
actor.key |
Nur vorhanden, wenn |
actor.applicationInfo |
Details zur Anwendung, die die Aktivität ausgelöst hat. |
actor.applicationInfo.oauthClientId |
OAuth-Client-ID der Drittanbieteranwendung, die zum Ausführen der Aktion verwendet wird. |
actor.applicationInfo.applicationName |
Name der Anwendung, die zum Ausführen der Aktion verwendet wurde. |
actor.applicationInfo.impersonation |
Gibt an, ob die Anwendung die Identität eines Nutzers angenommen hat. |
networkInfo |
Netzwerkinformationen des Nutzers, der die Aktion ausführt. |
resourceDetails[] |
Details zur Ressource, für die die Aktion ausgeführt wurde. |
NetworkInfo
Netzwerkinformationen des Nutzers, der die Aktion ausführt.
JSON-Darstellung |
---|
{ "ipAsn": [ integer ], "regionCode": string, "subdivisionCode": string } |
Felder | |
---|---|
ipAsn[] |
IP-Adresse des Nutzers, der die Aktion ausführt. |
regionCode |
Der ISO 3166-1-Alpha-2-Regionscode des Nutzers, der die Aktion ausführt. |
subdivisionCode |
ISO 3166-2-Code der Region (Bundesländer und Provinzen) für die Länder des Nutzers, der die Aktion ausführt. |
ResourceDetails
Details zur Ressource, für die die Aktion ausgeführt wurde.
JSON-Darstellung |
---|
{
"id": string,
"title": string,
"type": string,
"appliedLabels": [
{
object ( |
Felder | |
---|---|
id |
ID der Ressource. |
title |
Titel der Ressource. Bei einem Drive-Dokument wäre das beispielsweise der Titel des Dokuments. Bei einer E‑Mail wäre das der Betreff. |
type |
Typ der Ressource: Dokument, E-Mail, Chatnachricht |
appliedLabels[] |
activities.list of labels applied on the resource |
relation |
Definiert die Beziehung der Ressource zu den Ereignissen |
AppliedLabel
Details des Labels, das auf die Ressource angewendet wurde.
JSON-Darstellung |
---|
{ "id": string, "title": string, "fieldValues": [ { object ( |
Felder | |
---|---|
id |
Kennzeichnung des Labels – nur die Label-ID, nicht der vollständige OnePlatform-Ressourcenname. |
title |
Titel des Labels |
fieldValues[] |
activities.list: Liste der Felder, die Teil des Labels sind und vom Nutzer festgelegt wurden. Wenn ein Label ein Feld enthält, das nicht vom Nutzer festgelegt wurde, ist es nicht in dieser Liste enthalten. |
reason |
Der Grund, warum das Label auf die Ressource angewendet wurde. |
FieldValue
Details zum Feldwert, der vom Nutzer für das jeweilige Label festgelegt wurde.
JSON-Darstellung |
---|
{ "id": string, "displayName": string, "type": string, "reason": { object ( |
Felder | |
---|---|
id |
Kennung des Felds |
displayName |
Anzeigename des Felds |
type |
Typ des Felds |
reason |
Der Grund, warum das Feld auf das Label angewendet wurde. |
Union-Feld value . Die im Feld value gespeicherten Werte können nur einer der folgenden sein: |
|
unsetValue |
Wenn das Feld nicht festgelegt ist, ist der Wert „True“. |
longTextValue |
Einen langen Textwert festlegen. |
textValue |
Festlegen eines Textwerts. |
textListValue |
Festlegen eines Textlistenwerts. |
selectionValue |
Einen Auswahlwert festlegen, indem Sie einen einzelnen Wert aus einem Drop-down-Menü auswählen. |
selectionListValue |
Einen Wert für eine Auswahlliste festlegen, indem mehrere Werte aus einem Drop-down-Menü ausgewählt werden. |
integerValue |
Ganzzahlwert festlegen |
userValue |
Legen Sie einen Nutzerwert fest, indem Sie einen einzelnen Nutzer auswählen. |
userListValue |
Einen Wert für die Nutzerliste festlegen, indem Sie mehrere Nutzer auswählen. |
dateValue |
Festlegen eines Datumswerts. |
TextListValue
Festlegen eines Textlistenwerts.
JSON-Darstellung |
---|
{ "values": [ string ] } |
Felder | |
---|---|
values[] |
activities.list of text values. |
SelectionValue
Einen Auswahlwert festlegen, indem Sie einen einzelnen Wert aus einem Drop-down-Menü auswählen.
JSON-Darstellung |
---|
{ "id": string, "displayName": string, "badged": boolean } |
Felder | |
---|---|
id |
ID der Auswahl. |
displayName |
Anzeigename der Auswahl. |
badged |
Gibt an, ob die Auswahl mit einem Badge versehen ist. |
SelectionListValue
Einen Wert für eine Auswahlliste festlegen, indem mehrere Werte aus einem Drop-down-Menü ausgewählt werden.
JSON-Darstellung |
---|
{
"values": [
{
object ( |
Felder | |
---|---|
values[] |
activities.list of selections. |
UserValue
Legen Sie einen Nutzerwert fest, indem Sie einen einzelnen Nutzer auswählen.
JSON-Darstellung |
---|
{ "email": string } |
Felder | |
---|---|
email |
E‑Mail-Adresse des Nutzers. |
UserListValue
Einen Wert für die Nutzerliste festlegen, indem Sie mehrere Nutzer auswählen.
JSON-Darstellung |
---|
{
"values": [
{
object ( |
Felder | |
---|---|
values[] |
activities.list of users. |
Datum
Stellt ein ganzes Kalenderdatum oder einen Teil davon dar, z. B. einen Geburtstag. Die Uhrzeit und die Zeitzone werden entweder an einer anderen Stelle angegeben oder sind nicht relevant. Das Datum wird relativ zum gregorianischen Kalender angegeben. Das kann Folgendes darstellen:
- Ein vollständiges Datum mit Werten für Jahr, Monat und Tag, die nicht 0 sind.
- Einen Monat und einen Tag mit einem Jahr von 0 (z. B. ein Jahrestag).
- Ein Jahr für sich, mit einem Monat und einem Tag von 0.
- Ein Jahr und ein Monat mit einem Tag von 0, z. B. ein Ablaufdatum der Kreditkarte.
Ähnliche Typen:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
JSON-Darstellung |
---|
{ "year": integer, "month": integer, "day": integer } |
Felder | |
---|---|
year |
Jahr des Datums. Muss zwischen 1 und 9999 liegen oder kann 0 sein, wenn ein Datum ohne Jahresangabe angegeben wird. |
month |
Monat eines Jahres. Die Angabe muss zwischen 1 und 12 liegen. Sie kann auch 0 sein, wenn ein Jahr ohne Monat und Tag angegeben wird. |
day |
Tag des Monats. Die Angabe muss zwischen 1 und 31 liegen und für das Jahr und den Monat gültig sein. Sie kann auch 0 sein, wenn das Jahr bzw. der Monat angegeben wird, der Tag selbst jedoch nicht von Belang ist. |
Grund
Der Grund für die Anwendung des Labels/Felds.
JSON-Darstellung |
---|
{ "reasonType": string } |
Felder | |
---|---|
reasonType |
Der Typ des Grunds. |