Method: spaces.messages.reactions.list

Enumera las reacciones a un mensaje. Para ver un ejemplo, consulta Enumerar reacciones. Requiere autenticación de usuario y alcance chat.messages, chat.messages.readonly, chat.messages.reactions o chat.messages.reactions.readonly.

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. Cantidad máxima de reacciones mostradas. 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 reanudas desde una consulta anterior).

Un token de página recibido de una llamada de reacciones de lista anterior. Proporciona esto para recuperar la página siguiente.

Cuando se realiza 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 (ya sea 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úpalas entre 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

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:

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

object (Reaction)

Lista de reacciones en la página solicitada (o primera).

nextPageToken

string

Token de continuación para recuperar la siguiente página de resultados. No tiene información sobre la última página de resultados.

Permisos de autorización

Se necesita uno de los siguientes alcances 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.