Method: spaces.messages.reactions.list

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

Requiere autenticación del usuario con uno de los siguientes alcances de autorización:

  • 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

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.

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

filter

string

Opcional. Un filtro de búsqueda.

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

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

Las consultas no válidas se rechazan 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 una 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 para la última página de resultados.

Permisos 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.