Method: spaces.messages.reactions.list

列出对某条消息的回应。如需查看示例，请参阅列出消息的回应。

需要用户身份验证，并具有以下某个授权范围：

  • 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 请求

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

网址采用 gRPC 转码语法。

路径参数

参数
parent

string

必需。用户回应的消息。

格式：spaces/{space}/messages/{message}

查询参数

参数
pageSize

integer

可选。返回的回应数量上限。服务返回的回应数量可能少于此值。如果未指定，则默认值为 25。最大值为 200；大于 200 的值会更改为 200。
pageToken

string

可选。（如果从上一个查询继续）。

从之前的 list reactions 调用接收的页面令牌。利用其进行后续页面检索。

进行分页时，过滤条件值应与提供页面令牌的调用相一致。传递其他值可能会导致意外结果。
filter

string

可选。查询过滤条件。

您可以按表情符号（emoji.unicode 或 emoji.custom_emoji.uid）和用户 (user.name) 过滤回应。

如需过滤多种表情符号或用户的回应，请使用 OR 运算符（例如 emoji.unicode = "🙂" OR emoji.unicode = "👍" 和 user.name = "users/AAAAAA" OR user.name = "users/BBBBBB"）联接类似字段。

如需按表情符号和用户过滤回应，请使用 AND 运算符，例如 emoji.unicode = "🙂" AND user.name = "users/AAAAAA"。

如果您的查询同时使用 AND 和 OR，请使用括号对它们进行分组。

例如，以下查询有效：

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

以下查询无效：

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

无效查询会被拒绝并显示 INVALID_ARGUMENT 错误。

请求正文

请求正文必须为空。

响应正文

对列出回应的请求的响应。

如果成功，响应正文将包含结构如下的数据：

JSON 表示法 
{
  "reactions": [
    {
      object (Reaction)
    }
  ],
  "nextPageToken": string
}
字段
reactions[]

object (Reaction)

请求的（或第一）页面中的回应列表。
nextPageToken

string

用于检索下一页结果的接续令牌。对于结果的最后一页，此值为空。

授权范围

需要以下 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

如需了解详情，请参阅授权指南。