GSP250

概览

Google Chat 聊天机器人便于用户访问组织的数据和服务。用户可以通过聊天的形式与机器人对话。若要创建 Google Chat 聊天机器人，一种方法是使用 Google Apps 脚本。您还可以通过它轻松访问其他 Google 服务，例如 Google 云端硬盘、Gmail、Google 日历、Google 文档、Google 表格等。

在本实验中，您将使用 Google Apps 脚本创建一个简单的 Google Chat 聊天机器人，从而快速掌握 Google Chat 聊天机器人的入门知识。

实验任务

在本实验中，您将执行以下任务：

• 使用预先填充了事件处理脚本的模板创建一个聊天应用。
• 配置并发布 Google Chat 聊天机器人。

设置和要求

点击“开始实验”按钮前的注意事项

请阅读以下说明。实验是计时的，并且您无法暂停实验。计时器在您点击开始实验后即开始计时，显示 Google Cloud 资源可供您使用多长时间。

此实操实验可让您在真实的云环境中开展实验活动，免受模拟或演示环境的局限。为此，我们会向您提供新的临时凭据，您可以在该实验的规定时间内通过此凭据登录和访问 Google Cloud。

为完成此实验，您需要：

• 能够使用标准的互联网浏览器（建议使用 Chrome 浏览器）。

注意：请使用无痕模式（推荐）或无痕浏览器窗口运行此实验。这可以避免您的个人账号与学生账号之间发生冲突，这种冲突可能导致您的个人账号产生额外费用。

• 完成实验的时间 - 请注意，实验开始后无法暂停。

注意：请仅使用学生账号完成本实验。如果您使用其他 Google Cloud 账号，则可能会向该账号收取费用。

如何开始实验并登录 Google Cloud 控制台

1. 点击开始实验按钮。如果该实验需要付费，系统会打开一个对话框供您选择支付方式。左侧是“实验详细信息”窗格，其中包含以下各项：

   • “打开 Google Cloud 控制台”按钮
   • 剩余时间
   • 进行该实验时必须使用的临时凭据
   • 帮助您逐步完成本实验所需的其他信息（如果需要）

2. 点击打开 Google Cloud 控制台（如果您使用的是 Chrome 浏览器，请右键点击并选择在无痕式窗口中打开链接）。

   该实验会启动资源并打开另一个标签页，显示“登录”页面。

   提示：将这些标签页安排在不同的窗口中，并排显示。

   注意：如果您看见选择账号对话框，请点击使用其他账号。

3. 如有必要，请复制下方的用户名，然后将其粘贴到登录对话框中。

   {{{user_0.username | "<用户名>"}}}

   您也可以在“实验详细信息”窗格中找到“用户名”。

4. 点击下一步。

5. 复制下面的密码，然后将其粘贴到欢迎对话框中。

   {{{user_0.password | "<密码>"}}}

   您也可以在“实验详细信息”窗格中找到“密码”。

6. 点击下一步。

   重要提示：您必须使用实验提供的凭据。请勿使用您的 Google Cloud 账号凭据。 注意：在本实验中使用您自己的 Google Cloud 账号可能会产生额外费用。

7. 继续在后续页面中点击以完成相应操作：

   • 接受条款及条件。
   • 由于这是临时账号，请勿添加账号恢复选项或双重验证。
   • 请勿注册免费试用。

片刻之后，系统会在此标签页中打开 Google Cloud 控制台。

注意：如需访问 Google Cloud 产品和服务，请点击导航菜单，或在搜索字段中输入服务或产品的名称。

任务 1. 基于模板创建聊天应用

若要成功创建聊天机器人，请使用 Chat 应用模板创建一个新的 Google Apps 脚本项目。

注意：登录 Google Cloud 控制台可设置您的项目和凭证。在点击第 1 步中的 Google Apps 脚本编辑器链接之前，请确保您已登录 Google Cloud 控制台。

1. 点击此 Google Apps 脚本首页链接，打开 Google Apps 脚本在线编辑器。

2. 在 Google Workspace 插件入门下，点击 Chat 应用（中间版本）。

3. 点击未命名项目（当前名称）。

4. 在修改项目名称对话框中，将项目重命名为 Friendly Bot，然后点击重命名。

Google Chat 中的事件

Apps 脚本聊天机器人与 Google Chat 的大多数互动都是由事件驱动的。用户、聊天机器人和 Google Chat 通常按照一定的顺序进行互动。

1. 用户发起一项操作，例如将聊天机器人添加到聊天室、向聊天机器人发送私信 (DM) 或从聊天室中移除聊天机器人。
2. 该操作会触发一个事件，其目标直指 Google Chat 中的聊天机器人。
3. Google Chat 会调用聊天机器人脚本中定义的相应事件处理脚本。

Google Chat 会触发四种可由 Apps 脚本聊天机器人监听的事件：

• ADDED_TO_SPACE：用户本人将聊天机器人添加到聊天室或私信时，就会触发此事件。在 Apps 脚本中，请定义一个 onAddedToSpace() 函数来处理此事件。
• REMOVED_FROM_SPACE：用户从聊天室或私信中移除聊天机器人时，就会触发此事件。此事件不会向 Google Chat 发送回复消息。在 Apps 脚本中，请定义一个 onRemovedFromSpace() 函数来处理此事件。
• MESSAGE：用户直接在私信中或在聊天室中以 @mention 形式向聊天机器人发送消息时，就会触发此事件。在 Apps 脚本中，请定义一个 onMessage() 函数来响应此事件。

查看 MESSAGE 事件处理脚本的代码

Chat 应用模板会预先填充包含事件处理脚本的代码文件。

• 点击 Code.gs 文件，查看预先填充的事件处理脚本。

请注意 MESSAGE、ADDED_TO_SPACE 和 REMOVE_FROM_SPACE 事件的事件处理脚本，这些脚本会执行前面提到的特定函数以完成各种任务，例如在 Google Chat 中回复用户消息。

基于模板创建聊天应用

任务 2. 发布并测试聊天机器人

您必须先为 Google Cloud 项目启用 Google Chat API，并发布您的聊天机器人，然后才能运行和测试该机器人。

在此任务中，您将完成各种配置步骤以发布聊天机器人，包括配置 OAuth 权限请求页面、更新 Apps 脚本应用以引用适当的 Google Cloud 项目，以及更新 Google Chat API 配置以发布供测试的聊天机器人。

配置 OAuth 权限请求页面

1. 在 Google Cloud 控制台中，点击左上角的导航菜单 ()，然后依次选择 API 和服务 > OAuth 权限请求页面。

2. 点击开始使用。

3. 在“项目配置”页面中，如下配置应用信息部分，然后点击下一步：

字段	值
应用名称	Friendly Bot
用户支持邮箱	从下拉列表中选择邮箱 ID 。此邮箱也是实验说明左侧面板中的用户邮箱。

4. 在目标对象部分，选择内部，然后点击下一步。

5. 在联系信息部分，提供邮箱 ，然后点击下一步。

6. 接受相关政策，然后点击继续。然后点击创建。

点击检查我的进度以验证是否完成了以下目标：

配置用户权限请求页面

找到 Google Cloud 项目编号并更新 Apps 脚本应用以引用该编号

1. 在导航菜单 () 中，依次点击 Cloud 概览 > 信息中心。

2. 在信息中心内，找到项目信息部分。

3. 记录项目编号，以便在下一步中用来配置项目。

4. 返回 Apps 脚本编辑器，然后前往 Friendly Bot 项目的项目设置部分 ()。

5. 在 Google Cloud Platform (GCP) 项目下，点击更改项目。

6. 对于 GCP 项目编号，请输入您之前复制的项目编号。然后，点击设置项目。

配置并发布聊天机器人

1. 在 Apps 脚本编辑器中，依次点击部署 > 测试部署（屏幕右上角），然后点击“主要部署 ID”旁边的复制，以获取测试部署的主要部署 ID。

2. 在 Google Cloud 控制台中，前往导航菜单 ()，依次选择 API 和服务 > 库。

3. 在“库”中，搜索 Google Chat API，然后从结果列表中选择该 API。

此时 Google Chat API 应该已在该项目中启用。如果尚未启用，请点击启用。

4. 点击管理，然后点击 Google Chat API 的配置标签页。

5. 在配置对话框中，如下设置字段的值：

字段	值
应用名称	Friendly Bot
头像网址	https://goo.gl/kv2ENA
说明	Apps 脚本实验聊天机器人
功能	启用加入聊天室和群组对话
连接设置	选中 Apps 脚本，然后将第 1 步中复制的主要部署 ID 粘贴到部署 ID 框中。
公开范围

6. 点击保存。

7. 保存更改后，滚动到配置对话框顶部，将应用状态更新为已上线 - 可供用户使用。

您可能需要刷新页面才能看到应用状态字段。如果应用状态的值已设置为已上线 - 可供用户使用，则可以保留该值，但请务必在下一步中再次保存该页面。

8. 再次点击保存。

测试聊天机器人

您已进入最后一部分，接下来请完成以下步骤，在 Google Chat 中测试您的聊天机器人！

1. 点击 Google Chat 链接，打开 Google Chat。

2. 选择发起聊天。

3. 搜索 Friendly bot。

4. 在结果中，选择您创建的 Friendly Bot（Apps 脚本实验聊天机器人）开始聊天。

打开私信消息串后，您应该会看到该聊天机器人发来的一条消息，感谢您将其添加到私信中：

Thank you for adding me to a direct message, student XXXXX!

此回复是由 onAddedToSpace 函数发起的，该函数用于响应将聊天机器人添加到聊天室这一特定事件。

5. 最后，输入一条消息发给该聊天机器人，例如“Hello bot!”。

您应该会看到该聊天机器人把您的消息重复一遍，例如：

You said "Hello bot!"

此回复是由 onMessage 函数发起的，该函数用于响应用户私信聊天机器人这一特定事件。

恭喜！

您快速创建了一个回复用户消息的 Google Chat 聊天机器人！

后续步骤/了解详情

• 了解 Workspace 的其他功能：
  • Google Apps 脚本：用 4 行代码访问 Google 表格、Google 地图和 Gmail
• 请查阅以下实用资源：
  • Google Chat 文档网站
  • Apps 脚本聊天机器人快速入门
  • 创建新的聊天机器人
  • 发布聊天机器人
  • 创建互动卡片
  • 卡片参考文档
  • 事件对象参考文档
  • Gmail 高级服务参考文档
  • Calendar Apps 脚本 API 参考文档
  • Google Workspace 学习中心

Google Cloud 培训和认证

…可帮助您充分利用 Google Cloud 技术。我们的课程会讲解各项技能与最佳实践，可帮助您迅速上手使用并继续学习更深入的知识。我们提供从基础到高级的全方位培训，并有点播、直播和虚拟三种方式选择，让您可以按照自己的日程安排学习时间。各项认证可以帮助您核实并证明您在 Google Cloud 技术方面的技能与专业知识。

本手册的最后更新时间：2025 年 8 月 18 日

本实验的最后测试时间：2025 年 8 月 18 日

版权所有 2026 Google LLC 保留所有权利。Google 和 Google 徽标是 Google LLC 的商标。其他所有公司名和产品名可能是其各自相关公司的商标。