Method: spaces.messages.reactions.list

列出对消息的回应。如需查看示例，请参阅列出回应。需要用户身份验证以及 chat.messages、chat.messages.readonly、chat.messages.reactions 或 chat.messages.reactions.readonly 范围。

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

可选。（如果从之前的查询恢复。）

从上一个列表回应调用收到的页面令牌。利用其进行后续页面检索。

分页时，过滤器值应与提供页面令牌的调用匹配。传递不同的值可能会导致意外结果。
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

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