配置 Google Chat API

您创建的每个 Google Chat 应用都需要有自己的 已启用并配置 Chat API 的 Google Cloud 项目。当前页面 介绍了如何配置 Chat API。

前提条件

配置 Chat API

  1. 在 Google Cloud 控制台中，搜索“Google Chat API”并点击 Google Chat API，然后点击管理。

    前往 Chat API

  2. 点击配置标签页，然后输入以下信息 信息：

    • 应用名称：用户在与您的 Google Play 应用 Chat 应用。
    • 头像网址：指向方形图形图片的 HTTPS 网址 （例如，PNG 或 JPEG），尺寸至少为 128x128，以 您的 Chat 应用的头像。
    • 说明：对 Chat 应用的预期用途 。

  3. 要启用互动功能，请点击启用互动功能 可让用户与您的 Chat 应用，并使用下表完成操作 配置：

    字段 说明
    功能 一组字段，用于确定 Chat 应用如何与用户互动：
    • 接收 1 对 1 消息：用户可以直接在 Google Chat 中找到 Chat 应用并向其发送消息。
    • 加入聊天室和群组对话：用户可以将 Chat 应用添加到聊天室和群组对话。
    连接设置 Chat 应用的端点，可以是以下端点之一：
    • 应用网址：托管 Chat 应用实现的 HTTPS 端点。
    • Apps 脚本项目：实现 Chat 应用的 Apps 脚本项目的部署 ID。
    • Cloud Pub/Sub 主题名称：Chat 应用订阅为端点的 Pub/Sub 主题。
    • Dialogflow：使用 Dialogflow 集成注册 Chat 应用。如需了解详情，请参阅构建理解自然语言的 Dialogflow Google Chat 应用。
    斜杠命令 可在 Google Chat 中向用户显示的命令。允许用户在 Google Chat 中查看 Chat 应用的核心操作，并选择希望与之互动的具体操作。有关详情，请参阅以 Chat 应用的身份响应斜杠命令。
    链接预览 Chat 应用可识别的网址格式在用户发送链接时提供。如需了解详情，请参阅预览链接。
    公开范围 最多 5 人或者一个或多个 Google 群组可以查看和安装您的 Chat 扩展应用。使用此字段可测试您的 Chat 应用，或与您的团队分享 Chat 应用。有关详情，请参阅 Chat 应用的公开范围和发布设置。

  4. 将错误记录到 Cloud Logging， Chat 应用返回错误，请选择 将错误记录到日志记录复选框。如需了解详情，请参阅 查询 Chat 应用的错误日志。

  5. 点击保存。保存 Chat 应用时 您的 Chat 扩展应用可供 您 Google Workspace 组织中的特定用户。

授予他人配置 Chat 应用的权限

您可以 向特定用户授予访问权限 前往 Chat 应用配置页面。使用 Chat apps Owner 和 Chat apps Viewer IAM 角色。拥有这些角色的用户无法前往 Chat 扩展应用 API 和服务信息中心，但可以 前往 Google Cloud 控制台 Chat 应用的托管 Cloud 项目，如下所示：

https://console.developers.google.com/apis/api/chat.googleapis.com/hangouts-chat?project=PROJECT_ID

其中，PROJECT_ID 是 托管 Chat 应用的 Google Cloud 项目。