Method: spaces.messages.reactions.list

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

Erfordert eine Nutzerauthentifizierung mit einem der folgenden Autorisierungsbereiche:

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

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Die Nachricht, auf die Nutzer reagiert haben.

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

Suchparameter

Parameter
pageSize

integer

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

string

Optional. (Wenn die Abfrage fortgesetzt wird.)

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

Beim Paginieren muss der Filterwert mit dem Aufruf übereinstimmen, der das Seitentoken bereitgestellt hat. Wenn Sie einen anderen Wert übergeben, kann das zu unerwarteten Ergebnissen führen.
filter

string

Optional. Einen Abfragefilter.

Du kannst Reaktionen nach Emoji (emoji.unicode oder emoji.custom_emoji.uid) und Nutzer (user.name) filtern.

Wenn Sie Reaktionen nach mehreren Emojis oder Nutzern filtern möchten, können Sie ähnliche Felder mit dem Operator OR zusammenführen, z. B. emoji.unicode = "🙂" OR emoji.unicode = "👍" und user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

Wenn Sie Reaktionen nach Emoji und Nutzer filtern möchten, 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 mit 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 mit dem Fehler INVALID_ARGUMENT abgelehnt.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort auf eine Anfrage zum Auflisten von Reaktionen

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

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

object (Reaction)

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

string

Fortsetzungstoken zum Abrufen der nächsten Ergebnisseite. Bei der letzten Ergebnisseite ist er 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.