Method: spaces.messages.reactions.list

列出对消息的回应。如需查看示例,请参阅列出回应。需要用户身份验证

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.unicodeemoji.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"

如果您的查询同时使用 ANDOR,请使用括号将它们分组。

例如,以下查询有效:

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

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