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

可选。(如果是从上一个查询继续。)

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

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

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

有关详情,请参阅授权指南