Diese Seite wurde von der Cloud Translation API übersetzt.

Method: activities.list

HTTP-Anfrage
Pfadparameter
Anfrageparameter
Anfragetext
Antworttext
- JSON-Darstellung
Autorisierungsbereiche
ApplicationName
Aktivität
- JSON-Darstellung
  - JSON-Darstellung
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

Parameters
`userKey or all`	`string` Die Profil-ID oder die E-Mail-Adresse des Nutzers, für die 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 die zurückgegebene `ID` als `userKey`.
`applicationName`	`enum (ApplicationName)` Name der Anwendung, für die die Ereignisse abgerufen werden sollen.

userKey or all

string

Die Profil-ID oder die E-Mail-Adresse des Nutzers, für die 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 die zurückgegebene ID als userKey.

applicationName

enum (ApplicationName)

Name der Anwendung, für die die Ereignisse abgerufen werden sollen.

Abfrageparameter

Parameters
`actorIpAddress`	`string` 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`	`string` Die eindeutige ID des Kunden, für den Daten abgerufen werden sollen.
`endTime`	`string` 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: Datum der Berichtsanfrage durch die API: Zeitpunkt, zu dem die API den Bericht erstellt und abgerufen hat. Startzeit des Berichts: Der Beginn der im Bericht angezeigten Zeitspanne. `startTime` muss vor dem `endTime` (falls angegeben) und der aktuellen Uhrzeit der Anfrage liegen. Andernfalls gibt die API einen Fehler zurück. Ende des Berichts: Das Ende des Zeitraums, der im Bericht angezeigt wird. Beispielsweise kann der Zeitraum der in einem Bericht zusammengefassten Ereignisse im April beginnen und im Mai enden. Der Bericht selbst kann im August angefordert werden. Wenn `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`	`string` Der Name des Ereignisses, das von der API abgefragt wird. Jedes `eventName` bezieht sich auf einen bestimmten Google Workspace-Dienst oder eine bestimmte Google Workspace-Funktion, die die API in Ereignistypen organisiert. Ein Beispiel hierfür sind die Google Kalender-Termine in den Berichten der Admin-Konsole. Die `type`-Struktur der Kalendereinstellungen enthält alle `eventName`-Aktivitäten für Kalender, die von der API gemeldet werden. Wenn ein Administrator eine Kalendereinstellung ändert, meldet die API diese Aktivität in den Kalendereinstellungen `type` und `eventName`. Weitere Informationen zu `eventName`-Abfragestrings und -parametern finden Sie oben in der Liste der Ereignisnamen für verschiedene Anwendungen unter `applicationName`.
`filters`	`string` Der Abfragestring `filters` ist eine durch Kommas getrennte Liste aus Ereignisparametern, die durch relationale Operatoren geändert werden. Ereignisparameter haben das Format `{parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...`. Diese Ereignisparameter sind einem bestimmten `eventName` zugeordnet. Wenn der Parameter der Anfrage nicht zum `eventName` gehört, wird ein leerer Bericht zurückgegeben. Weitere Informationen zu den verfügbaren `eventName`-Feldern für jede Anwendung und den zugehörigen Parametern finden Sie in der Tabelle ApplicationName. Klicken Sie dann im Anhang der gewünschten Anwendung auf die Seite „Aktivitätsereignisse“. In den folgenden Drive-Aktivitätsbeispielen enthält die zurückgegebene Liste alle `edit`-Ereignisse, bei denen der Parameterwert `doc_id` den Bedingungen des relationalen Operators entspricht. Im ersten Beispiel gibt die Anfrage alle bearbeiteten Dokumente mit einem `doc_id`-Wert zurück, der gleich `12345` ist. Im zweiten Beispiel werden im Bericht alle bearbeiteten Dokumente zurückgegeben, bei denen der `doc_id`-Wert nicht gleich `98765` ist. Der Operator `<>` ist im Abfragestring der Anfrage (`%3C%3E`) URL-codiert: `GET...&eventName=edit&filters=doc_id==12345 GET...&eventName=edit&filters=doc_id%3C%3E98765` Eine `filters`-Abfrage unterstützt diese relationalen Operatoren: `==` – „gleich“. `<>` – nicht gleich. Muss URL-codiert sein (%3C%3E). `<` – „kleiner als“. Muss URL-codiert sein (%3C). `<=` – „kleiner oder gleich“. Muss URL-codiert sein (%3C=). `>` – „größer als“. Muss URL-codiert sein (%3E). `>=`: „größer als oder gleich“. Muss URL-codiert sein (%3E=). 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`	`integer` Legt fest, wie viele Aktivitätsdatensätze auf jeder Antwortseite angezeigt werden. Wenn die Anfrage beispielsweise `maxResults=1` festlegt und der Bericht zwei Aktivitäten enthält, hat er zwei Seiten. Das Attribut `nextPageToken` der Antwort enthält das Token für die zweite Seite. Der Abfragestring `maxResults` ist in der Anfrage optional. Der Standardwert ist 1.000.
`orgUnitID`	`string` 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. Daten vor dem 17. Dezember 2018 werden nicht in den gefilterten Ergebnissen angezeigt.
`pageToken`	`string` Das Token, das die nächste Seite angeben soll. Ein Bericht mit mehreren Seiten enthält die Property `nextPageToken` in der Antwort. Geben Sie in der Folgeanfrage zum Abrufen der nächsten Seite des Berichts den Wert `nextPageToken` im Abfragestring `pageToken` ein.
`startTime`	`string` 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 `startTime` bis zum `endTime`. `startTime` muss vor dem `endTime` (falls angegeben) und der aktuellen Uhrzeit der Anfrage liegen. Andernfalls gibt die API einen Fehler zurück.
`groupIdFilter`	`string` 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 (`Activity`) } ], "nextPageToken": string }

Felder
`kind`	`string` Der Typ der API-Ressource. Bei einem Aktivitätsbericht lautet der Wert `reports#activities`.
`etag`	`string` Das ETag der Ressource.
`items[]`	`object (Activity)` Jede Aktivität wird in der Antwort aufgezeichnet.
`nextPageToken`	`string` Token zum Abrufen der nächsten Seite des Berichts. Der Wert `nextPageToken` wird im Abfragestring `pageToken` der Anfrage verwendet.

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

JSON-Darstellung
{ "kind": string, "etag": string, "ownerDomain": string, "ipAddress": string, "events": [ { "type": string, "name": string, "parameters": [ { "messageValue": { "parameter": [ { object (`NestedParameter`) } ] }, "name": string, "value": string, "multiValue": [ string ], "intValue": string, "multiIntValue": [ string ], "boolValue": boolean, "multiMessageValue": [ { "parameter": [ { object (`NestedParameter`) } ] } ] } ] } ], "id": { "time": string, "uniqueQualifier": string, "applicationName": string, "customerId": string }, "actor": { "profileId": string, "email": string, "callerType": string, "key": string } }

{
  "kind": string,
  "etag": string,
  "ownerDomain": string,
  "ipAddress": string,
  "events": [
    {
      "type": string,
      "name": string,
      "parameters": [
        {
          "messageValue": {
            "parameter": [
              {
                object (NestedParameter)
              }
            ]
          },
          "name": string,
          "value": string,
          "multiValue": [
            string
          ],
          "intValue": string,
          "multiIntValue": [
            string
          ],
          "boolValue": boolean,
          "multiMessageValue": [
            {
              "parameter": [
                {
                  object (NestedParameter)
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "id": {
    "time": string,
    "uniqueQualifier": string,
    "applicationName": string,
    "customerId": string
  },
  "actor": {
    "profileId": string,
    "email": string,
    "callerType": string,
    "key": string
  }
}

Felder
`kind`	`string` Der Typ der API-Ressource. Bei einem Aktivitätsbericht lautet der Wert `audit#activity`.
`etag`	`string` Das ETag des Eintrags.
`ownerDomain`	`string` 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`	`string` 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[]`	`object` Aktivitätsereignisse im Bericht.
`events[].type`	`string` Ereignistyp. Der Google Workspace-Dienst oder die Google Workspace-Funktion, den bzw. die ein Administrator ändert, wird in der Property „`type`“ angegeben, die ein Ereignis mithilfe der Property „`eventName`“ identifiziert. Eine vollständige Liste der `type`-Kategorien der API finden Sie oben im Abschnitt `applicationName` in der Liste der Ereignisnamen für verschiedene Anwendungen.
`events[].name`	`string` Name des Ereignisses. Dies ist der spezifische Name der Aktivität, die von der API gemeldet wird. Und jede `eventName` bezieht sich auf einen bestimmten Google Workspace-Dienst oder eine bestimmte Google Workspace-Funktion, die die API in Ereignistypen organisiert. Allgemein für `eventName`-Anfrageparameter: Wenn keine `eventName` angegeben wird, gibt der Bericht alle möglichen Instanzen eines `eventName` zurück. Wenn Sie ein `eventName` anfordern, gibt die API-Antwort alle Aktivitäten zurück, die dieses `eventName` enthalten. Weitere Informationen zu `eventName`-Eigenschaften finden Sie oben in der Liste der Ereignisnamen für verschiedene Anwendungen unter `applicationName`.
`events[].parameters[]`	`object` Parameterwertpaare für verschiedene Anwendungen. Weitere Informationen zu `eventName`-Parametern finden Sie oben in der Liste der Ereignisnamen für verschiedene Anwendungen unter `applicationName`.
`events[].parameters[].messageValue`	`object` 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 `[{parameter: [{name: city, value: abc}]}]` haben.
`events[].parameters[].messageValue.parameter[]`	`object (NestedParameter)` Parameterwerte
`events[].parameters[].name`	`string` Name des Parameters.
`events[].parameters[].value`	`string` Stringwert des Parameters.
`events[].parameters[].multiValue[]`	`string` Stringwerte des Parameters.
`events[].parameters[].intValue`	`string (int64 format)` Ganzzahlwert des Parameters.
`events[].parameters[].multiIntValue[]`	`string (int64 format)` Ganzzahlwerte des Parameters.
`events[].parameters[].boolValue`	`boolean` Boolescher Wert des Parameters.
`events[].parameters[].multiMessageValue[]`	`object` Aktivitäten.list mit `messageValue` Objekten
`events[].parameters[].multiMessageValue[].parameter[]`	`object (NestedParameter)` Parameterwerte
`id`	`object` Eindeutige Kennung für jeden Aktivitätsdatensatz.
`id.time`	`string` Zeitpunkt des Auftretens der Aktivität. Die Angabe erfolgt in Sekunden der UNIX-Epoche.
`id.uniqueQualifier`	`string (int64 format)` Eindeutiger Qualifier, wenn mehrere Ereignisse dieselbe Zeit haben.
`id.applicationName`	`string` Name der Anwendung, zu der das Ereignis gehört. Mögliche Werte finden Sie in der Liste der Anwendungen oben unter `applicationName`.
`id.customerId`	`string` Die eindeutige Kennung für ein Google Workspace-Konto.
`actor`	`object` Nutzer, der die Aktion ausführt
`actor.profileId`	`string` 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`	`string` 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`	`string` Der Typ des Schauspielers.
`actor.key`	`string` Nur vorhanden, wenn `callerType` den Wert `KEY` hat. Kann die `consumer_key` des Anforderers für OAuth 2LO API-Anfragen oder eine Kennung für Robot-Konten sein.