Diese Seite wurde von der Cloud Translation API übersetzt.

Method: activities.list

HTTP-Anfrage
Pfadparameter
Anfrageparameter
Anfragetext
Antworttext
- JSON-Darstellung
Autorisierungsbereiche
Anwendungsname
Aktivität
- JSON-Darstellung
  - JSON-Darstellung
Testen!

Ruft eine Liste von Aktivitäten für ein bestimmtes Kundenkonto und eine bestimmte Anwendung ab, z. B. die Admin-Konsole oder die Google Drive-Anwendung. Weitere Informationen finden Sie in den Leitfäden 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

Parameter

Parameter
`userKey or all`	`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 oder die primäre E-Mail-Adresse eines Nutzers 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 die zurückgegebene `ID` als `userKey`.
`applicationName`	`enum (ApplicationName)` Anwendungsname, für den die Ereignisse abgerufen werden sollen.

userKey or all

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 oder die primäre E-Mail-Adresse eines Nutzers 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 die zurückgegebene ID als userKey.

applicationName

enum (ApplicationName)

Anwendungsname, für den die Ereignisse abgerufen werden sollen.

Abfrageparameter

Parameter
`actorIpAddress`	`string` Die IP-Adresse (Host = Internet Protocol) des Hosts, an dem das Ereignis aufgetreten ist. Das ist eine zusätzliche Möglichkeit, um die Zusammenfassung eines Berichts mithilfe der IP-Adresse des Nutzers zu filtern, dessen Aktivität gemeldet wurde. Diese IP-Adresse entspricht möglicherweise nicht dem physischen Standort des Nutzers. Die IP-Adresse kann z. B. 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 API-Anfrage für einen Bericht: Zeitpunkt, zu dem die API den Bericht erstellt und abgerufen hat Beginn des Berichts: Beginn des im Bericht angezeigten Zeitraums. `startTime` muss vor dem `endTime` (falls angegeben) und der aktuellen Uhrzeit liegen, wenn die Anfrage gestellt wird. Andernfalls gibt die API einen Fehler zurück. Ende des Berichts: Das Ende des im Bericht angezeigten Zeitraums. Beispielsweise kann der Zeitraum von Ereignissen, die in einem Bericht zusammengefasst sind, im April beginnen und im Mai enden. Der Bericht selbst kann im August angefordert werden. Wenn die `endTime` nicht angegeben ist, gibt der Bericht alle Aktivitäten vom `startTime` bis zur aktuellen Zeit zurück. Falls der `startTime` mehr als 180 Tage zurückliegt, werden auch die letzten 180 Tage angezeigt.
`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 von der API in Arten von Ereignissen organisiert wird. Ein Beispiel hierfür sind die Google Kalender-Termine in den Berichten der Admin-Konsole. Die Struktur der Kalendereinstellungen `type` enthält alle `eventName`-Aktivitäten in Google Kalender, die von der API gemeldet werden. Wenn ein Administrator eine Kalendereinstellung ändert, meldet die API diese Aktivität in den Parametern `type` und `eventName` in den Kalendereinstellungen. Weitere Informationen zu Abfragestrings und -parametern für `eventName` finden Sie oben in der Liste der Ereignisnamen für verschiedene Anwendungen in `applicationName`.
`filters`	`string` Der Abfragestring `filters` ist eine durch Kommas getrennte Liste von Ereignisparametern, die von relationalen Operatoren bearbeitet werden. Ereignisparameter haben das Format `{parameter1 name}{relational operator}{parameter1 value},{parameter2 name}{relational operator}{parameter2 value},...` Diese Ereignisparameter sind mit einem bestimmten `eventName` verknüpft. Ein leerer Bericht wird zurückgegeben, wenn der Parameter nicht zur `eventName` gehört. Weitere Informationen zu den verfügbaren `eventName`-Feldern für die einzelnen Anwendungen und die zugehörigen Parameter finden Sie in der Tabelle Anwendungsname. Klicken Sie dann im Anhang der gewünschten Anwendung auf die Seite „Aktivitätsereignisse“. In den folgenden Beispielen für Drive-Aktivitäten enthält die zurückgegebene Liste alle `edit`-Ereignisse, bei denen der Parameterwert `doc_id` den Bedingungen entspricht, die vom relationalen Operator definiert wurden. Im ersten Beispiel gibt die Anfrage alle bearbeiteten Dokumente mit einem `doc_id`-Wert zurück, der `12345` entspricht. Im zweiten Beispiel gibt der Bericht alle bearbeiteten Dokumente zurück, bei denen der Wert `doc_id` nicht `98765` ist. Der Operator `<>` ist im Abfragestring (`%3C%3E`) der Anfrage URL-codiert: `GET...&eventName=edit&filters=doc_id==12345 GET...&eventName=edit&filters=doc_id%3C%3E98765` Eine `filters`-Abfrage unterstützt die folgenden relationalen Operatoren: `==`: &gleich; #39; `<>`: 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. 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`	`integer` Bestimmt, wie viele Aktivitätsdatensätze auf jeder Antwortseite angezeigt werden. Wenn die Anfrage beispielsweise `maxResults=1` enthält und der Bericht zwei Aktivitäten enthält, hat der Bericht zwei Seiten. Die `nextPageToken`-Property der Antwort enthält das Token zur zweiten Seite. Der Abfragestring `maxResults` ist in der Anfrage optional. Der Standardwert ist 1.000.
`orgUnitId`	`string` ID der Organisationseinheit, für die ein 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 in den gefilterten Ergebnissen nicht angezeigt.
`pageToken`	`string` Das Token, das die nächste Seite angeben soll. Ein Bericht mit mehreren Seiten enthält in der Antwort die Property `nextPageToken`. Geben Sie in Ihrer Folgeanfrage zum Abrufen der nächsten Seite des Berichts den Wert `nextPageToken` in den Abfragestring `pageToken` ein.
`startTime`	`string` Legt den Beginn des im Bericht angezeigten Zeitraums fest. Das Datum hat das RFC 3339-Format, z. B. 2010-10-28T10:26:35.000Z. Der Bericht gibt alle Aktivitäten vom `startTime` bis zum `endTime` zurück. `startTime` muss vor dem `endTime` (falls angegeben) und der aktuellen Uhrzeit liegen, wenn die Anfrage gestellt wird. 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 Aktivitäten nur für die Nutzer, die Teil von mindestens einer der hier genannten Gruppen-IDs sind. Format: "id:abc123,id:xyz456"

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Vorlage für eine Sammlung von Aktivitäten.

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` ETag der Ressource.
`items[]`	`object (Activity)` Jeder Aktivitätseintrag in der Antwort.
`nextPageToken`	`string` Token zum Abrufen der nächsten Seite des Berichts. Der Wert `nextPageToken` wird im Abfragestring `pageToken` verwendet.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

https://www.googleapis.com/auth/admin.reports.audit.readonly

Weitere Informationen finden Sie unter OAuth 2.0.

Anwendungsname

Enums
`access_transparency`	Die Berichte zu Access Transparency-Aktivitäten in Google Workspace enthalten Informationen zu verschiedenen Arten von Access Transparency-Aktivitätsereignissen.
`admin`	In den Aktivitätsberichten der Admin-Konsole finden Sie Kontoinformationen zu verschiedenen Arten von Administratoraktivitäten.
`calendar`	Die Aktivitätsberichte der Google Kalender App liefern Informationen zu verschiedenen Aktivitäten in Google Kalender.
`chat`	Die Berichte enthalten Informationen zu verschiedenen Chat-Aktivitäten.
`drive`	Die Aktivitätsberichte der Google Drive-Anwendung geben Informationen zu verschiedenen Google Drive-Aktivitätsereignissen zurück. Der Bericht zur Drive-Aktivität ist nur für Google Workspace Business- und Enterprise-Kunden verfügbar.
`gcp`	Die Aktivitätsberichte der Google Cloud Platform-Anwendung geben Informationen zu verschiedenen GCP-Aktivitätsereignissen zurück.
`gplus`	Die Aktivitätsberichte der Google+ App geben Informationen zu verschiedenen Google+ Aktivitätsereignissen zurück.
`groups`	Die Aktivitätsberichte der Google Groups-App geben Informationen zu verschiedenen Gruppenaktivitäten zurück.
`groups_enterprise`	Die Berichte zu Aktivitäten in Enterprise-Gruppen enthalten Informationen zu verschiedenen Aktivitäten für Unternehmensgruppen.
`jamboard`	Die Berichte zu Jamboard-Aktivitäten enthalten Informationen zu verschiedenen Aktivitäten von Jamboard.
`login`	In den Aktivitätsberichten der Log-in-App werden Kontoinformationen zu verschiedenen Arten von Anmeldeaktivitäten angezeigt.
`meet`	Der Bericht zur Meet-Auditaktivität enthält Informationen zu verschiedenen Meet-Audit-Aktivitätsereignissen.
`mobile`	Der Bericht zur Geräteprüfung enthält Informationen zu verschiedenen Arten von Aktivitätsereignissen.
`rules`	Der Bericht zur Regelaktivität enthält Informationen zu verschiedenen Arten von Aktivitätsereignissen.
`saml`	Der Bericht zur SAML-Aktivität enthält Informationen zu verschiedenen SAML-Aktivitätsereignissen.
`token`	Die Aktivitätsberichte der Tokenanwendung geben Kontoinformationen zu verschiedenen Arten von Tokenaktivitätsereignissen zurück.
`user_accounts`	Die Aktivitätsberichte der Nutzerkonten enthalten Kontoinformationen zu verschiedenen Arten von Aktivitätsereignissen der Nutzerkonten.
`context_aware_access`	Die Berichte zu kontextsensitiven Zugriffsaktivitäten geben Informationen zu Nutzern zurück, die aufgrund von Regeln für den kontextsensitiven Zugriff auf Zugriffe verweigert wurden.
`chrome`	Die Chrome-Aktivitätsberichte enthalten Informationen zu Chrome-Browsern und Chrome OS-Ereignissen.
`data_studio`	Die Data Studio-Aktivitätsberichte enthalten Informationen zu verschiedenen Arten von Data Studio-Aktivitätsereignissen.
`keep`	Die Aktivitätsberichte der Notizen-App geben Informationen zu verschiedenen Google Notizen-Aktivitätsereignissen zurück. Der Bericht zur Aktivität in Google Notizen ist nur für Google Workspace Business- und Enterprise-Kunden verfügbar.

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` ETag des Eintrags.
`ownerDomain`	`string` Das ist die Domain, die vom Ereignis des Berichts betroffen ist. Beispiel: Domain der Admin-Konsole oder des Eigentümers der Drive-Anwendung.
`ipAddress`	`string` IP-Adresse des Nutzers, der die Aktion ausführt. Das ist die IP-Adresse (Internet Protocol) des Nutzers bei der Anmeldung in Google Workspace. Diese kann, muss aber nicht, den physischen Standort des Nutzers angeben. Die IP-Adresse kann z. B. 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, die ein Administrator ändert, wird in der Property `type` identifiziert. Sie identifiziert ein Ereignis mit der Property `eventName`. Eine vollständige Liste der `type`-Kategorien der API finden Sie in der Liste der Ereignisnamen für die verschiedenen Anwendungen oben in `applicationName`.
`events[].name`	`string` Name des Ereignisses. Dies ist der spezifische Name der von der API gemeldeten Aktivität. Jede `eventName` bezieht sich auf einen bestimmten Google Workspace-Dienst oder eine bestimmte Funktion, die von der API in Arten von Ereignissen organisiert wird. Für `eventName`-Anfrageparameter im Allgemeinen: Wenn kein `eventName` angegeben ist, gibt der Bericht alle möglichen Instanzen eines `eventName` zurück. Wenn Sie eine `eventName` anfordern, gibt die API-Antwort alle Aktivitäten zurück, die diese `eventName` enthalten. Es ist möglich, dass die zurückgegebenen Aktivitäten neben den angeforderten noch weitere `eventName`-Eigenschaften enthalten. Weitere Informationen zu `eventName`-Properties finden Sie in der Liste der Ereignisnamen für die verschiedenen Anwendungen oben in `applicationName`.
`events[].parameters[]`	`object` Parameterwerte für verschiedene Anwendungen. Weitere Informationen zu `eventName`-Parametern finden Sie in der Liste der Ereignisnamen für die verschiedenen Anwendungen oben in `applicationName`.
`events[].parameters[].messageValue`	`object` Verschachtelte Parameterwertepaare, die diesem Parameter zugeordnet sind. Ein komplexer Werttyp für einen Parameter wird als Liste von Parameterwerten zurückgegeben. Der Parameter „address“ 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` activity.list von `messageValue` Objekten.
`events[].parameters[].multiMessageValue[].parameter[]`	`object (NestedParameter)` Parameterwerte
`id`	`object` Eindeutige Kennung für jeden Aktivitätseintrag.
`id.time`	`string` Zeitpunkt des Auftretens der Aktivität. Dies ist in UNIX-Epochenzeit in Sekunden.
`id.uniqueQualifier`	`string (int64 format)` Eindeutiger Kennzeichner, wenn mehrere Ereignisse gleichzeitig vorliegen.
`id.applicationName`	`string` Name der Anwendung, zu der das Ereignis gehört Mögliche Werte finden Sie in der Liste der Anwendungen oben in `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 ist möglicherweise nicht vorhanden, wenn der Akteur kein Google Workspace-Nutzer ist oder die Nummer 105250506097979753968, die als Platzhalter-ID fungiert.
`actor.email`	`string` Die primäre E-Mail-Adresse des Akteurs. Möglicherweise nicht vorhanden, wenn dem Schauspieler keine E-Mail-Adresse zugeordnet ist.
`actor.callerType`	`string` Die Art des Schauspielers.
`actor.key`	`string` Nur vorhanden, wenn `callerType` `KEY` ist. Kann die `consumer_key` des Anfragenden für OAuth 2LO API-Anfragen oder eine Kennung für Robot-Konten sein.