Method: spaces.messages.reactions.list

Listet Reaktionen auf eine Nachricht auf. Ein Beispiel finden Sie unter Reaktionen auflisten. Erfordert eine Nutzerauthentifizierung.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameters
parent

string

Erforderlich. Die Nachricht, auf die Nutzer reagiert haben.

Format: spaces/{space}/messages/{message}

Suchparameter

Parameters
pageSize

integer

Optional. Die maximale Anzahl der zurückgegebenen Reaktionen. Der Dienst kann weniger Reaktionen zurückgeben als dieser Wert. Wenn keine Vorgabe erfolgt, gilt der Standardwert 25. Der Maximalwert beträgt 200; Werte über 200 werden in 200 geändert.

pageToken

string

Optional. (Bei Fortsetzung einer vorherigen Abfrage.)

Ein Seitentoken, das von einem vorherigen Aufruf der Listenreaktionen empfangen wurde. Geben Sie diese an, um die nachfolgende Seite abzurufen.

Beim Paginieren sollte der Filterwert mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Die Übergabe eines anderen Werts kann zu unerwarteten Ergebnissen führen.

filter

string

Optional. Ein Abfragefilter.

Sie können Reaktionen nach Emojis (emoji.unicode oder emoji.custom_emoji.uid) und Nutzer (user.name) filtern.

Wenn Sie Reaktionen für mehrere Emojis oder Nutzer filtern möchten, führen Sie ähnliche Felder mit dem Operator OR zusammen, z. B. emoji.unicode = "🙂" OR emoji.unicode = "👍" und user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

Um Reaktionen nach Emojis und Nutzern zu filtern, verwenden Sie den Operator AND, z. B. emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

Wenn in Ihrer Abfrage sowohl AND als auch OR verwendet werden, gruppieren Sie sie in Klammern.

Die folgenden Abfragen sind beispielsweise gültig:

user.name = "users/{user}"
emoji.unicode = "🙂"
emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR emoji.unicode = "👍"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" AND user.name = "users/{user}"
(emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}")
AND user.name = "users/{user}"

Die folgenden Abfragen sind ungültig:

emoji.unicode = "🙂" AND emoji.unicode = "👍"
emoji.unicode = "🙂" AND emoji.custom_emoji.uid = "{uid}"
emoji.unicode = "🙂" OR user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}" OR
user.name = "users/{user}"
emoji.unicode = "🙂" OR emoji.custom_emoji.uid = "{uid}"
AND user.name = "users/{user}"

Ungültige Abfragen werden vom Server mit dem Fehler INVALID_ARGUMENT abgelehnt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender Struktur:

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

object (Reaction)

Liste der Reaktionen auf der angeforderten (oder ersten) Seite.

nextPageToken

string

Fortsetzungs-Token zum Abrufen der nächsten Ergebnisseite. Für die letzte Ergebnisseite ist dieses Feld leer.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.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.