Hier werden Ereignisse aus einem Google Chat-Gruppenbereich aufgeführt. Die Nutzlast enthält für jedes Ereignis die neueste Version der Chatressource. Wenn Sie beispielsweise Ereignisse zu neuen Mitgliedern eines Gruppenbereichs auflisten, gibt der Server Membership Ressourcen zurück, die die neuesten Mitgliedschaftsdetails enthalten. Wenn neue Mitglieder im angeforderten Zeitraum entfernt wurden, enthält die Ereignisnutzlast eine leere Membership-Ressource.
Erfordert die Nutzerauthentifizierung. Damit der authentifizierte Nutzer Ereignisse auflisten kann, muss er Mitglied des Gruppenbereichs sein.
Erforderlich. Ressourcenname des Google Chat-Bereichs, in dem die Ereignisse aufgetreten sind.
Format: spaces/{space}.
Abfrageparameter
Parameter
pageSize
integer
Optional. Die maximale Anzahl der zurückgegebenen Gruppenbereichsereignisse. Der Dienst gibt möglicherweise weniger als diesen Wert zurück.
Bei negativen Werten wird der Fehler INVALID_ARGUMENT zurückgegeben.
pageToken
string
Optional. Ein Seitentoken, das von einem vorherigen Aufruf von Listenbereichsereignissen empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.
Beim Paginieren müssen alle anderen für die Auflistung von Gruppenbereichsereignissen bereitgestellten Parameter mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Wenn Sie für die anderen Parameter unterschiedliche Werte übergeben, kann das zu unerwarteten Ergebnissen führen.
filter
string
Erforderlich. Einen Abfragefilter.
Sie müssen mindestens einen Ereignistyp (eventType) mit dem Operator „hat :“ angeben. Wenn Sie nach mehreren Ereignistypen filtern möchten, verwenden Sie den Operator OR. Schließen Sie Batch-Ereignistypen aus Ihrem Filter aus. Die Anfrage gibt automatisch alle zugehörigen Batch-Ereignisse zurück. Wenn du beispielsweise nach neuen Reaktionen (google.workspace.chat.reaction.v1.created) filterst, gibt der Server auch Ereignisse für neue Reaktionen im Batch (google.workspace.chat.reaction.v1.batchCreated) zurück. Eine Liste der unterstützten Ereignistypen findest du in der SpaceEvents-Referenzdokumentation.
Optional können Sie auch nach Startzeit (startTime) und Endzeit (endTime) filtern:
startTime: Exklusiver Zeitstempel, ab dem die Listen der Ereignisse für den Gruppenbereich beginnen sollen. Sie können Ereignisse auflisten, die bis zu 28 Tage zurückliegen. Wenn Sie nichts angeben, werden Gruppenbereichsereignisse der letzten 28 Tage aufgeführt.
endTime: Inklusiver Zeitstempel, bis zu dem Gruppenbereichsereignisse aufgeführt werden. Wenn Sie nichts angeben, werden Ereignisse bis zum Zeitpunkt der Anfrage aufgeführt.
Verwenden Sie den Operator „ist gleich“ = und das Format RFC-3339, um eine Start- oder Endzeit anzugeben. Wenn Sie sowohl nach startTime als auch nach endTime filtern möchten, verwenden Sie den Operator AND.
Die folgenden Abfragen sind beispielsweise gültig:
startTime="2023-08-23T19:20:33+00:00" AND
endTime="2023-08-23T19:21:54+00:00"
startTime="2023-08-23T19:20:33+00:00" AND
(eventTypes:"google.workspace.chat.space.v1.updated" OR
eventTypes:"google.workspace.chat.message.v1.created")
Die folgenden Abfragen sind ungültig:
startTime="2023-08-23T19:20:33+00:00" OR
endTime="2023-08-23T19:21:54+00:00"
eventTypes:"google.workspace.chat.space.v1.updated" AND
eventTypes:"google.workspace.chat.message.v1.created"
Ungültige Abfragen werden vom Server mit dem Fehler INVALID_ARGUMENT abgelehnt.
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortnachricht für das Auflisten von Gruppenbereichsereignissen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
Die Ergebnisse werden in chronologischer Reihenfolge zurückgegeben (ältestes Ereignis zuerst). Hinweis: Das Feld permissionSettings wird bei Listenanfragen nicht im Gruppenbereichsobjekt zurückgegeben.
nextPageToken
string
Fortsetzungstoken, mit dem weitere Ereignisse abgerufen werden. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-02-27 (UTC)."],[[["Lists events from a specified Google Chat space, including new members, messages, and reactions, with the payload containing the most recent version of the resource."],["Requires user authentication and membership in the space to list events, returning data chronologically with optional pagination."],["Allows filtering by event types, start time, and end time to refine the results of the listed events."],["The response includes an array of space events and a token for retrieving subsequent pages if available."],["Needs specific authorization scopes for accessing and retrieving the chat space data."]]],["This documentation outlines how to list events from a Google Chat space using the `GET` method. Key actions include: specifying the space via the `parent` path parameter, filtering events by type and time using the `filter` query parameter, and setting the number of events returned with `pageSize`. `pageToken` is used for pagination. Authentication requires user membership in the space and specific OAuth scopes. The response body includes a list of `spaceEvents` and a `nextPageToken` for further results.\n"]]
