Method: spaces.messages.reactions.list

Liste les réactions à un message. Pour obtenir un exemple, consultez Répertorier les réactions. Nécessite l'authentification de l'utilisateur et le champ d'application chat.messages, chat.messages.readonly, chat.messages.reactions ou chat.messages.reactions.readonly.

Requête HTTP :

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

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Message avec lequel les utilisateurs ont réagi.

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

Paramètres de requête

Paramètres
pageSize

integer

Facultatif. Nombre maximal de réactions renvoyées. Le service peut renvoyer moins de réactions que cette valeur. Si aucune valeur n'est spécifiée, la valeur par défaut est 25. La valeur maximale est 200. Les valeurs supérieures sont remplacées par 200.
pageToken

string

Facultatif. (Si vous réactivez une requête précédente)

Jeton de page reçu d'un appel de réactions de liste précédent. Fournissez-le pour récupérer la page suivante.

Lors de la pagination, la valeur du filtre doit correspondre à l'appel ayant fourni le jeton de page. La transmission d'une valeur différente peut entraîner des résultats inattendus.
filter

string

Facultatif. Filtre de requête.

Vous pouvez filtrer les réactions par emoji (emoji.unicode ou emoji.custom_emoji.uid) ou par utilisateur (user.name).

Pour filtrer les réactions de plusieurs emoji ou utilisateurs, associez des champs similaires à l'opérateur OR, tels que emoji.unicode = "🙂" OR emoji.unicode = "👍" et user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

Pour filtrer les réactions par emoji et utilisateur, utilisez l'opérateur AND tel que emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

Si votre requête utilise à la fois AND et OR, regroupez-les entre parenthèses.

Par exemple, les requêtes suivantes sont valides:

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}"

Les requêtes suivantes ne sont pas valides:

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}"

Les requêtes non valides sont refusées par le serveur avec une erreur INVALID_ARGUMENT.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :

Représentation JSON 
{
  "reactions": [
    {
      object (Reaction)
    }
  ],
  "nextPageToken": string
}
Champs
reactions[]

object (Reaction)

Liste des réactions sur la page demandée (ou première page).
nextPageToken

string

Jeton de continuité pour récupérer la page de résultats suivante. Ce champ est vide pour la dernière page de résultats.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

  • 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

Pour en savoir plus, consultez le guide sur les autorisations.