创建一个您可以直接发送消息并通过回显消息进行响应的 Google Chat 应用。
下图显示了其架构和消息传递模式:
在上图中,与 Apps 脚本聊天应用交互的用户具有以下信息流:
- 用户通过私信或在 Chat 聊天室中向 Chat 应用发送消息。
- 在位于 Google Cloud 中的 Apps 脚本中实现的 Chat 应用逻辑接收和处理消息。
- (可选)Chat 应用逻辑可以与 Google Workspace 服务(例如日历或表格)或其他 Google 服务(例如 Google 地图或 YouTube)集成。
- Chat 应用逻辑会将响应发回 Chat 中的 Chat 应用服务。
- 系统将响应传送给用户。
目标
- 设置环境。
- 设置脚本。
- 发布 Chat 应用。
- 测试 Chat 应用。
前提条件
- 有权访问 Chat 的 Google Workspace 帐号。
- 具有一个 Google Cloud 项目。
设置您的环境
在 Google Cloud 控制台中打开您的 Cloud 项目
打开您打算用于此示例的 Cloud 项目(如果尚未打开):
- 在 Google Cloud 控制台中,前往选择项目页面。
- 选择您要使用的 Google Cloud 项目。或者,点击创建项目,然后按照屏幕上的说明操作。如果您创建了 Google Cloud 项目,则可能需要为该项目启用结算功能。
启用 Chat API
在使用 Google API 之前,您需要在 Google Cloud 项目中启用这些 API。您可以在单个 Google Cloud 项目中启用一个或多个 API。在 Google Cloud 控制台中,启用 Google Chat API。
配置 OAuth 权限请求页面
所有使用 OAuth 2.0 的应用都需要配置同意屏幕。配置应用的 OAuth 同意屏幕可以定义向用户显示的内容和应用审核者,并注册您的应用,以便日后发布。
- 在 Google Cloud 控制台中,依次点击“菜单”图标 > API 和服务 > OAuth 同意屏幕。
- 为您的应用选择用户类型,然后点击创建。
- 填写应用注册表单,然后点击 Save and Continue(保存并继续)。
目前,您可以跳过添加范围的步骤,然后点击保存并继续。 将来,如果您要创建要在 Google Workspace 组织外部使用的应用,则必须添加并验证该应用所需的授权范围。
- 如果您选择了外部作为用户类型,请添加测试用户:
- 在测试用户下,点击添加用户。
- 输入您的电子邮件地址和任何其他获授权测试用户,然后点击保存并继续。
- 查看您的应用注册摘要。如要进行更改,请点击修改。如果应用注册看起来正常,请点击 Back to Dashboard。
设置脚本
如需设置脚本,请使用模板,然后在 Apps 脚本中设置您的 Cloud 项目。
基于模板创建脚本
- 前往 Apps 脚本使用入门页面。
- 点击 Chat App 模板。您可能需要向下滚动才能看到此模板。
- 点击未命名项目,输入
Quickstart app
,然后点击重命名。
复制 Cloud 项目编号
- 在 Google Cloud 控制台中,转到您的 Cloud 项目。
- 依次点击“设置和实用程序”图标 > 项目设置。
- 复制项目编号。
设置 Apps 脚本项目的 Cloud 项目
- 在 Chat 应用 Apps 脚本项目中,点击 Project Settings 图标
。
- 在 Google Cloud Platform (GCP) Project 下,点击更改项目。
- 在 GCP 项目编号中,粘贴 Google Cloud 项目编号。
- 点击设置项目。
现在,您已经有了可正常工作的应用代码,可以按以下步骤进行试用,然后再根据需要进行自定义。
打开 Apps 脚本模板时,确保您登录的是正确的 Google 帐号。当前帐号有时可能会在您不知情的情况下切换到默认帐号。
创建测试部署
您需要此 Apps 脚本项目的部署 ID,以便在下一步中使用。
如需获取 Head 部署 ID,请执行以下操作:
- 在 Chat 应用 Apps 脚本项目中,依次点击部署 > 测试部署。
- 复制 Head 部署 ID 以供在后续步骤中使用,然后点击完成。
发布 Chat 应用
从 Google Cloud 控制台发布 Chat 应用。
- 在 Google Cloud 控制台中,搜索
Google Chat API
,然后点击 Google Chat API。 - 点击管理。
点击配置并设置 Chat 应用:
- 在应用名称字段中,输入
Quickstart app
。 - 在头像网址字段中,输入
https://developers.google.com/chat/images/quickstart-app-avatar.png
。 - 在说明字段中,输入
Quickstart app
。 - 在“功能”下方,选择接收 1 对 1 消息和加入聊天室和群组对话。
- 在“连接设置”下,选择 Apps 脚本项目,然后将部署 ID 粘贴到该字段中。
- 在“公开范围”下,选择您网域中的特定人员和群组,然后输入您的电子邮件地址。
- 在应用名称字段中,输入
点击保存并刷新页面。
在配置页面上的应用状态下,将状态设置为已发布 - 可供用户使用。
点击保存。
Chat 应用现在可以回复消息了。
测试 Chat 应用
- 打开 Chat。
- 依次点击开始聊天 > 查找应用,向应用发送新的私信。
- 在“查找应用”页面上,搜索“
Quickstart App
”。 - 点击 quickstart App 旁边的 Chat。
- 在与该应用的新私信对话中,输入
Hello
,然后按enter
。
该应用感谢你添加,并回显你的消息。
后续步骤
- 创建互动卡片 - 卡片消息支持定义的布局、按钮等互动界面元素以及图片等富媒体。使用卡片消息呈现详细信息,从用户那里收集信息并引导用户执行下一步。
- 支持斜杠命令 - 使用斜杠命令,您可以注册并通告用户通过输入以正斜杠 (
/
) 开头的命令(例如/help
)即可向您的应用发出的特定命令。 - 启动对话框 - 对话框是基于卡片的窗口化界面,应用可以打开以与用户互动。多张卡片可按顺序串联在一起,这有助于用户完成多步流程,例如填写表单数据。