Method: spaces.spaceEvents.list

Hier werden Ereignisse aus einem Google Chat-Gruppenbereich aufgeführt. Für jedes Ereignis enthält die Nutzlast 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.

Ein Beispiel finden Sie unter Ereignisse aus einem Google Chat-Gruppenbereich auflisten.

HTTP-Anfrage

GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

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. Die Übergabe unterschiedlicher Werte an die anderen Parameter kann 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 Sie beispielsweise nach neuen Reaktionen filtern (google.workspace.chat.reaction.v1.created), gibt der Server auch neue Ereignisse im Batch zurück (google.workspace.chat.reaction.v1.batchCreated). Eine Liste der unterstützten Ereignistypen finden Sie in der Referenzdokumentation zu SpaceEvents.

Optional können Sie auch nach Beginn (startTime) und Endzeit (endTime) filtern:

  • startTime: Exklusiver Zeitstempel, ab dem die Listen der Gruppenbereiche 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 nicht angegeben, 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 zum Auflisten von Space-Ereignissen.

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

JSON-Darstellung 
{
  "spaceEvents": [
    {
      object (SpaceEvent)
    }
  ],
  "nextPageToken": string
}
Felder
spaceEvents[]

object (SpaceEvent)

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, das zum Abrufen weiterer Ereignisse verwendet wird. Wenn dieses Feld weggelassen wird, gibt es keine nachfolgenden Seiten.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.spaces
  • https://www.googleapis.com/auth/chat.spaces.readonly
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.readonly
  • https://www.googleapis.com/auth/chat.memberships
  • https://www.googleapis.com/auth/chat.memberships.readonly
  • https://www.googleapis.com/auth/chat.messages.reactions
  • https://www.googleapis.com/auth/chat.messages.reactions.readonly

Weitere Informationen finden Sie im Leitfaden zur Autorisierung.