Method: spaces.messages.reactions.list

Permite mostrar una lista de las reacciones a un mensaje. Para ver un ejemplo, consulta Cómo mostrar una lista de reacciones a un mensaje.

Se requiere la autenticación del usuario.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

Obligatorio. El mensaje al que reaccionaron los usuarios

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

Parámetros de consulta

Parámetros
pageSize

integer

Opcional. Es la cantidad máxima de reacciones que se devuelven. El servicio puede mostrar menos reacciones que este valor. Si no se especifica, el valor predeterminado es 25. El valor máximo es 200; los valores superiores a 200 se cambian a 200.
pageToken

string

Opcional. (si se reanuda desde una consulta anterior).

Un token de página recibido de una llamada a list reactions anterior. Proporciona esto para recuperar la página siguiente.

Durante la paginación, el valor del filtro debe coincidir con la llamada que proporcionó el token de la página. Pasar un valor diferente puede generar resultados inesperados.
filter

string

Opcional. Un filtro de consulta

Puedes filtrar las reacciones por emoji (emoji.unicode o emoji.custom_emoji.uid) y usuario (user.name).

Para filtrar las reacciones de varios emojis o usuarios, une campos similares con el operador OR, como emoji.unicode = "🙂" OR emoji.unicode = "👍" y user.name = "users/AAAAAA" OR user.name = "users/BBBBBB".

Para filtrar reacciones por emoji y usuario, usa el operador AND, como emoji.unicode = "🙂" AND user.name = "users/AAAAAA".

Si tu consulta usa AND y OR, agrúpalos con paréntesis.

Por ejemplo, las siguientes consultas son válidas:

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

Las siguientes consultas no son válidas:

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

El servidor rechaza las consultas no válidas con un error INVALID_ARGUMENT.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta a una solicitud de reacciones de lista.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "reactions": [
    {
      object (Reaction)
    }
  ],
  "nextPageToken": string
}
Campos
reactions[]

object (Reaction)

Es la lista de reacciones en la página solicitada (o primera).
nextPageToken

string

Es un token de Continuation para recuperar la siguiente página de resultados. Está vacía en la última página de resultados.

Alcances de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • 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

Para obtener más información, consulta la Guía de autorización.