Listet Ereignisse aus einem Google Chat-Bereich auf. Bei jedem Ereignis enthält die payload die neueste Version der Chat-Ressource. Wenn Sie beispielsweise Ereignisse zu neuen Mitgliedern des Gruppenbereichs auflisten, gibt der Server Membership
-Ressourcen zurück, die die aktuellen Details zur Mitgliedschaft enthalten. Wenn während des angeforderten Zeitraums neue Mitglieder entfernt wurden, enthält die Ereignisnutzlast eine leere Membership
-Ressource.
Erfordert eine Nutzerauthentifizierung. Damit Ereignisse aufgelistet werden können, muss der authentifizierte Nutzer Mitglied des Gruppenbereichs sein.
Ein Beispiel finden Sie unter Termine aus einem Google Chat-Bereich auflisten.
HTTP-Anfrage
GET https://chat.googleapis.com/v1/{parent=spaces/*}/spaceEvents
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
parent |
Erforderlich. Ressourcenname des Google Chat-Bereichs, in dem die Ereignisse aufgetreten sind. Format: |
Abfrageparameter
Parameter | |
---|---|
pageSize |
Optional. Die maximale Anzahl der zurückgegebenen Gruppenbereichereignisse. Der Dienst gibt möglicherweise weniger als diesen Wert zurück. Negative Werte geben den Fehler |
pageToken |
Ein Seitentoken, das von einem vorherigen Listenaufruf für Gruppenbereiche mit einer Liste empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen. Beim Paginieren müssen alle anderen Parameter, die zum Auflisten von Gruppenbereichsereignissen bereitgestellt werden, mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Die Übergabe verschiedener Werte an die anderen Parameter kann zu unerwarteten Ergebnissen führen. |
filter |
Erforderlich. Ein Abfragefilter. Sie müssen mindestens einen Ereignistyp ( Optional können Sie auch nach Beginn (
Verwenden Sie zum Angeben einer Start- oder Endzeit den Operator Die folgenden Abfragen sind beispielsweise gültig:
Die folgenden Abfragen sind ungültig:
Ungültige Abfragen werden vom Server mit dem Fehler |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Antwortnachricht zum Auflisten von Gruppenbereichen.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"spaceEvents": [
{
object ( |
Felder | |
---|---|
spaceEvents[] |
Die Ergebnisse werden in chronologischer Reihenfolge zurückgegeben (ältestes Ereignis zuerst). |
nextPageToken |
Fortsetzungs-Token zum Abrufen weiterer Ereignisse. 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.