Google Apps 脚本聊天应用快速入门

创建一个 Google Chat 应用，您可以直接回复消息，并通过回显消息来回应。

目标

  • 设置环境。
  • 设置脚本。
  • 发布应用。
  • 运行脚本。

前提条件

设置您的环境

在 Google Cloud 控制台中打开 Cloud 项目

打开您打算用于此示例的 Cloud 项目（如果尚未打开）：

  1. 在 Google Cloud 控制台中，前往选择项目页面。

    选择 Cloud 项目

  2. 选择您要使用的 Google Cloud 项目。或者，点击创建项目，然后按照屏幕上的说明操作。如果您创建 Google Cloud 项目，可能需要为项目启用结算功能。

启用 Chat API

在使用 Google API 之前，您需要先在 Google Cloud 项目中启用这些 API。您可以在单个 Google Cloud 项目中启用一个或多个 API。

  • 在 Google Cloud 控制台中，启用 Google Chat API。

    启用 API

所有使用 OAuth 2.0 的应用都需要配置同意屏幕。配置应用的 OAuth 权限请求页面定义向用户显示的内容和应用的审核者，并注册应用以便日后发布。

  1. 在 Google Cloud 控制台中，依次转到“菜单”图标 > API 和服务 > OAuth 同意屏幕。

    转到 OAuth 同意屏幕

  2. 选择应用的用户类型，然后点击 Create。
  3. 填写应用注册表单，然后点击保存并继续。

  4. 目前，您可以跳过添加范围，然后点击保存并继续。 将来，当您创建应用以在 Google Workspace 组织之外使用时，必须添加并验证应用所需的授权范围。

  5. 如果您选择外部作为用户类型，请添加测试用户：
    1. 在测试用户下，点击添加用户。
    2. 输入您的电子邮件地址和任何其他已获授权的测试用户，然后点击保存并继续。
  6. 查看您的应用注册摘要。若要进行更改，请点击修改。如果应用注册看起来没有问题，请点击 Back to Dashboard（返回信息中心）。

设置脚本

如需设置该脚本，您可以使用模板，然后在 Apps 脚本中设置 Cloud 项目。

通过模板创建脚本

  1. 前往 Apps 脚本使用入门页面。
  2. 点击聊天应用模板。您可能需要向下滚动才能看到此模板。
  3. 点击未命名的项目，输入 Quickstart app，然后点击重命名。

复制 Cloud 项目编号

  1. 在 Google Cloud 控制台中，转到您的 Cloud 项目。
  2. 依次点击“设置与实用程序” > 项目设置。
  3. 复制项目编号。

设置 Apps 脚本项目的 Cloud 项目

  1. 在 Chat 应用 Apps 脚本项目中，点击项目设置 项目设置的图标。
  2. 在 Google Cloud Platform (GCP) 项目下，点击更改项目。
  3. 在 GCP 项目编号中，粘贴 Google Cloud 项目编号。
  4. 点击设置项目。

您现在有可以正常运行的应用代码（如以下步骤所述），然后进行自定义以满足您的要求。

打开 Apps 脚本模板时，请确保您登录的是正确的 Google 帐号。当前的帐号有时可以切换到默认帐号，而无需您注意。

创建测试部署

您需要此 Apps 脚本项目的部署 ID，以便在下一步中使用。

如需获取头部署 ID，请执行以下操作：

  1. 在 Chat 应用 Apps 脚本项目中，依次点击部署 > 测试部署。
  2. 复制头部署 ID 以在后续步骤中使用，然后点击完成。

发布 Chat 应用

通过 Google Cloud 控制台发布 Chat 应用。

  1. 在 Google Cloud Console 中，搜索 Google Chat API，然后点击 Google Chat API。
  2. 点击管理。

  3. 点击配置并设置 Chat 应用：

    1. 在应用名称字段中，输入 Quickstart app。
    2. 在头像网址字段中，输入 https://developers.google.com/chat/images/quickstart-app-avatar.png。
    3. 在说明字段中，输入 Quickstart app。
    4. 在“功能”下方，选择接收 1 对 1 消息和加入聊天室和群组对话。
    5. 在“连接设置”下，选择 Apps 脚本项目，然后将部署 ID 粘贴到该字段中。
    6. 在“权限”下方，选择您网域中的特定用户和群组，然后输入您的电子邮件地址。

  4. 点击保存并刷新页面。

  5. 在配置页面上的应用状态下，将状态设置为已发布 - 可供用户使用。

  6. 点击保存。

Chat 应用已准备好回复消息。

运行脚本

  1. 打开 Chat。
  2. 依次点击发起聊天 > 查找应用，向应用发送新的私信。
  3. 在“查找应用”页面上，搜索 Quickstart App。
  4. 点击快速入门应用旁边的 Chat。
  5. 在应用的新私信对话中，输入 Hello 并按 enter 键。

该应用感谢您添加它，您可以回复您的消息。

后续步骤

  • 创建互动卡片 - 卡片消息支持已定义的布局、交互式界面元素（如按钮）和富媒体（如图片）。使用卡片消息显示详细信息、向用户收集信息，并引导用户采取后续步骤。
  • 支持斜杠命令：借助斜杠命令，您可以注册并通告用户可以向您的应用提供的特定命令，具体方法是输入以正斜杠 (/) 开头的命令，例如 /help。
  • Launch Dialogs - 对话框是基于窗口的接口，您的应用可打开此类接口以与用户交互。可将多个卡片依序串联起来，这有助于用户完成多步骤流程，例如填写表单数据。