本指南介绍了如何使用 Google Chat API 的 CustomEmoji
资源的 get
方法来获取有关自定义表情符号的详细信息。
自定义表情符号仅适用于 Google Workspace 账号,并且您的管理员必须为贵组织启用自定义表情符号。如需了解详情,请参阅了解 Google Chat 中的自定义表情符号和管理自定义表情符号权限。
前提条件
Node.js
- 拥有可访问 Google Chat 的 Google Workspace 商务版或企业版账号。
- 设置环境:
- 创建 Google Cloud 项目。
- 配置 OAuth 权限请求页面。
- 启用并配置 Google Chat API,为您的 Chat 应用指定名称、图标和说明。
- 安装 Node.js Cloud 客户端库。
- 根据您希望在 Google Chat API 请求中进行身份验证的方式,创建访问凭据:
- 如需以 Chat 用户身份进行身份验证,请创建 OAuth 客户端 ID 凭据,并将凭据保存为名为
credentials.json
的 JSON 文件,保存到本地目录。 - 如需以 Chat 应用的身份进行身份验证,请创建服务账号凭据,并将凭据保存为名为
credentials.json
的 JSON 文件。
- 如需以 Chat 用户身份进行身份验证,请创建 OAuth 客户端 ID 凭据,并将凭据保存为名为
- 选择授权范围,具体取决于您是想以用户身份还是以 Chat 应用身份进行身份验证。
获取有关自定义表情符号的详细信息
如需获取有关自定义表情符号的详细信息,请在请求中传递以下内容:用户身份验证
- 指定
chat.customemojis
授权范围。 - 调用
GetCustomEmoji
方法。 - 在请求正文中,将
name
设置为要获取的自定义表情符号的资源名称。
以下示例会获取自定义表情符号的详细信息。
Node.js
如需运行此示例,请替换以下内容:
EMOJI_NAME
:自定义表情符号的唯一名称,位于emoji_name
字段中。您可以通过调用ListCustomEmoji()
方法获取 ID,也可以通过 Chat API 异步创建自定义表情符号后从返回的响应正文中获取 ID。