配置 Google Chat API

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

前提条件

配置 Chat API

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

    前往 Chat API

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

    • 应用名称：用户在与您的 Chat 应用互动时使用的名称。
    • 头像网址：指向显示为 Chat 应用的头像的方形图形图片（例如 PNG 或 JPEG）的 HTTPS 网址，图片大小至少为 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 应用可识别的网址格式，并在用户发送链接时提供额外内容。如需了解详情，请参阅预览链接。
    公开范围 最多可以有 5 个个人或一个或多个 Google 群组查看和安装您的 Chat 应用。您可以使用此字段测试您的 Chat 应用，或与您的团队分享该 Chat 应用。如需了解详情，请参阅 Chat 应用的公开范围和发布设置。

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

  5. 点击保存。保存 Chat 应用配置后，您的 Chat 应用便可供 Google Workspace 组织中的指定用户使用。

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

您可以向特定用户授予访问 Chat 应用配置页面的权限。使用 Chat 应用 Owner 和 Chat 应用查看者 IAM 角色。具有这些角色的用户无法使用 API 和服务信息中心导航到 Chat 应用配置页面，但可以通过导航到 Chat 应用的托管 Cloud 项目的 Google Cloud 控制台来访问配置页面，如下所示：

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

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