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

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

创建一个 Google Chat 应用,您可以直接回复消息,并通过回显消息进行响应。

目标

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

前提条件

设置您的环境

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

打开尚未用于此示例的 Cloud 项目(如果尚未打开):

  1. 前往 Google Cloud 控制台
  2. 点击 Google Cloud 旁边的向下箭头 。此时会显示一个列出当前项目的对话框。
  3. 选择您的项目,然后点击打开。控制台会打开您的项目。

启用 Chat API

在使用 Google API 之前,您需要先在 Google Cloud 项目中启用它们。您可以在单个 Google Cloud 项目中启用一个或多个 API。
  • 在 Google Cloud 控制台中,启用 Google Chat API。

    启用 API

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

  1. 在您的 Google Cloud 项目中,转到“菜单”图标 > API 和服务 > OAuth 同意屏幕

    转到 OAuth 同意屏幕

  2. 为您的应用选择用户类型,然后点击创建
  3. 填写应用注册表单,然后点击保存并继续
  4. 目前,您可以跳过添加范围,然后点击保存并继续。 将来,当您创建应用以在 Google Workspace 组织之外使用时,您必须添加并验证应用所需的授权范围。
  5. 如果您选择外部作为用户类型,请添加测试用户:
    1. 在“测试用户”下,点击添加用户
    2. 输入您的电子邮件地址和任何其他已获授权的测试用户,然后点击保存并继续
  6. 查看您的应用注册摘要。若要进行更改,请点击修改。 如果应用注册看起来没有问题,请点击返回信息中心

设置脚本

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

通过模板创建脚本

  1. 转到 Apps 脚本使用入门页面
  2. 点击 Chat App 模板。您可能需要向下滚动才能看到此模板。
  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 控制台中,搜索 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 脚本项目并将 Deployment ID 粘贴到该字段中。
    6. 在“权限”下方,选择您网域中的特定用户和群组,然后输入您的电子邮件地址。
  4. 点击保存并刷新页面。

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

  6. 点击保存

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

运行脚本

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

该应用感谢你添加信息,并且你的回答会得到回应。

后续步骤

  • 创建互动式卡片 - 卡片消息支持定义的布局、互动式界面元素(如按钮)和富媒体(如图片)。使用卡片消息呈现详细信息、向用户收集信息并引导用户采取下一步行动。
  • 支持斜杠命令 - 借助斜杠命令,您可以注册并通告用户可以向您的应用提供的特定命令,方法是输入以正斜杠 (/) 开头的命令,例如 /help
  • Launch Dialogs - 对话框是基于窗口的接口,您的应用可打开该接口以与用户互动。可将多个卡片依序组合在一起,以帮助用户完成多步流程,例如填写表单数据。