Method: customEmojis.list

列出向已通过身份验证的用户显示的自定义表情符号。

要求进行用户身份验证。

HTTP 请求

GET https://chat.googleapis.com/v1/customEmojis

网址采用 gRPC 转码语法。

查询参数

参数
pageSize

integer

可选。返回的自定义表情符号的数量上限。服务返回的自定义表情符号可以少于此值。如果未指定，默认值为 25。最大值为 200；大于 200 的值会更改为 200。
pageToken

string

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

从上一个列表自定义表情符号调用收到的页面令牌。利用其进行后续页面检索。

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

string

可选。查询过滤条件。

支持按创作者进行过滤。

如需按创作者过滤，您必须指定有效的值。目前，只有 creator("users/me") 和 NOT creator("users/me") 支持按自定义表情符号是否由发起调用的用户创建进行过滤。

例如，以下查询会返回调用方创建的自定义表情符号：

creator("users/me")

服务器拒绝无效查询并显示 INVALID_ARGUMENT 错误。

请求正文

请求正文必须为空。

响应正文

对一系列自定义表情符号的响应。

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

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

object (CustomEmoji)

无序列表。所请求的页面（或第一页）中的自定义表情符号列表。
nextPageToken

string

可作为 pageToken 发送以检索下一页结果的令牌。如果为空，则没有后续页面。

授权范围

需要以下 OAuth 范围之一：

  • https://www.googleapis.com/auth/chat.customemojis
  • https://www.googleapis.com/auth/chat.customemojis.readonly

有关详情，请参阅授权指南。