释放 Action

邀请用户测试您的 Action,让您有机会在公开发布 Action 之前收集早期反馈,并解决发现的技术问题或用户体验问题。

Actions 控制台支持发布环境,以便向一组有限的用户授予测试新 Action 或现有 Action 的新版本的权限,然后再将其公开发布。

版本的生命周期

下图显示了 Action 生命周期可能采取的路径:

显示释放 Action 的可能生命周期路径的示意图
图 1. Action 的生命周期随发布环境变化。

Actions 控制台支持两种类型的非正式版发布环境:

  • Alpha 版:此渠道应该用于快速测试 Action 的早期版本。

    • 允许您将 Action 分发给一小部分用户,而无需经过完整的 Google 审核。
    • 系统会向用户显示警告,告知其相应 Action 尚未经过 Google 政策合规性审核。
    • 非常适合内部测试。
  • Beta 版:通过此渠道,您可以在通过完整的 Google 审核后将 Action 分发给有限的用户。

    • 您应该使用此渠道向组织外部的用户授予对 Action 的早期版本的访问权限。
    • 系统会告知用户该操作是预览版。
    • 由于 Beta 版已通过 Google 审核,因此您可以随时选择将其公开发布,而无需 Google 再次审核。

发布环境比较

下表总结了各个部署渠道之间的区别。

模拟器 Alpha Beta 版 生产
目标观众 仅限开发者 您的团队以及朋友和家人的早期测试人员 您的团队以外的测试人员 所有 Google 助理用户
需要 Google 审核
有权访问的人 仅限开发者 开发者定义的用户列表。用户必须选择启用。 开发者定义的用户列表。用户必须选择启用。 面向所有 Google 助理用户公开发布
最大用户数 1 20 200 不适用
适用的国家/地区 模拟器和所有支持 Google 助理的设备 所有支持 Google 助理的设备 所有支持 Google 助理的设备 所有支持 Google 助理的设备
Actions Builder 支持 支持 支持
Actions SDK 支持 支持 支持
Dialogflow 支持 支持 支持
智能家居 支持(需要账号关联) 不支持 不支持
模板 支持 不支持 不支持
显式调用 支持 支持 支持
隐式调用 支持 支持 支持
账号关联 支持 支持 支持

管理 Alpha 版或 Beta 版测试

如需设置 Alpha 版或 Beta 版测试,请按以下步骤操作:

  1. 点击管理 Alpha 版测试人员管理 Beta 版测试人员
  2. 输入测试人员的电子邮件地址(用英文逗号分隔)。您最多可以指定 20 名测试人员进行 Alpha 版测试,以及指定最多 200 名测试人员进行 Beta 版测试。

    “添加 Beta 版测试人员”的屏幕截图

  3. 复制加入测试链接,以便分享给测试人员。

  4. 点击保存

您应向测试人员发送一封邀请电子邮件,其中包含指向您的 Alpha 版或 Beta 版 Action 的链接(即加入测试链接)。如需了解详情,请参阅获取反馈

加入测试链接代表你的 Action 目录页面,绝不会更改。该链接可将测试人员指向您的目录页面,并查看符合条件的环境的选择启用卡片。如果您针对 Alpha 版和 Beta 版列出了相同的测试人员,则他们也符合这两种测试条件,并会首先看到选择加入 Alpha 版本的卡片。

为 Alpha 版或 Beta 版实现执行方式

发布渠道信息不包含在 Google 助理向你的执行方式发出的 HTTP 请求中。如需在你的执行方式中处理发布渠道,你应提供不同的执行方式网址(例如,一个用于 Beta 版执行方式的网址,另一个用于你的 Action 正式版的执行方式网址)。

获取反馈

您的 Action 发布到 Alpha 或 Beta 发布渠道后,您应该通过分享加入测试链接(与 Google 助理目录列表相同)来邀请测试人员。

请务必告知测试人员,他们必须:

  • 在其移动设备上下载 Google 助理应用,以便执行 Alpha 版或 Beta 版测试。
  • 使用您指定为 Alpha 版或 Beta 版测试人员的帐号登录 Google 助理应用。

您部署 Action 后,任何新测试人员都需要等待至少 3 小时,才能使用选择加入链接访问 Action。

用户点击此链接后,会被定向到相应 Action 的目录页面。他们应该点击 Action 目录页面底部的 I'm in(我启用)按钮,以便首次选择成为测试人员。

测试人员在手机上选择启用后,您的 Action 会立即显示在其所有设备上。测试人员将在 Google 助理应用的我的应用部分看到您的 Action,并带有以下某种模式:Alpha 版Beta 版不测试No testing 选项将为用户提供 Action 的正式版(如果有)。如果没有正式版,则不会向用户提供任何内容。

最佳实践

  • 确保用户可以加入测试。测试人员需要拥有 Google 帐号 (@gmail.com) 或 G Suite 帐号才能加入测试。
  • 选择合适的测试类型。Alpha 版测试组的规模应该很小,而且测试最不稳定的实验性 Action 版本(例如在您的公司或团队内部测试)。让更多用户参与 Beta 版测试,以测试即将发布的稳定版 Action。
  • 为测试人员提供一个渠道,以便其向您发送反馈。Alpha 和 Beta 渠道仅供您自己的测试人员使用。确保让他们能够通过电子邮件、网站、消息论坛或其他合适的机制提供反馈。
  • 对同一操作同时运行测试。您可以同时进行 Alpha 版和 Beta 版测试。

已知问题

  • Alpha 版或 Beta 版不支持使用网页版 Google 助理目录。 确保您的测试人员在其移动设备(Android 或 iOS)上点击该链接。
  • 您所做的更改可能需要几个小时才会生效。请稍等片刻,然后再与您的用户分享加入测试链接。

创建新的 Alpha 版或 Beta 版

如需将 Action 部署到 Alpha 或 Beta 发布渠道,请按以下步骤操作:

  1. 在 Actions 控制台中,点击 Deploy > Release
  2. 点击开始使用新版本

    开始发布新版本的屏幕截图

  3. 选择 Alpha 版Beta 版,然后点击提交

  4. 如果系统提示您完成操作审核要求核对清单中的必要步骤,

  5. 为版本选择语言(如果适用于您的项目)。

  6. 点击提交

您提交 Alpha 版或 Beta 版后,它会显示在管理版本部分中。

将现有版本从 Alpha 版或 Beta 版升级为正式版

正式版本可以是向所有 Google 助理用户全面发布,也可以是针对特定地区或一定比例的用户分阶段发布。分阶段发布有助于测试 Action 项目的稳定性。最好向一小部分用户发布,然后逐步增加,直至达到 100% 的用户为止。这样,您就可以在面向整个用户群发布应用之前解决错误。

分阶段发布

通过分阶段发布的方式,开发者可以先面向一部分用户发布应用,然后再逐步向所有用户推出,从而管理正式版。您可以逐步增加部署的区域或用户百分比。

如需分阶段发布您的 Action,请按以下步骤操作:

  1. 管理版本下,选择要升级到正式版发布的版本。
  2. 点击管理部署
  3. 选择部署到生产环境
  4. 选择分阶段发布
  5. 点击选择发布类型
  6. 选择指定地理位置用户百分比。如需详细了解此选项,请参阅按指定位置发布按用户群百分比发布

    选择分阶段发布模式的屏幕截图

  7. 点击提交

如需推进发布阶段,请参阅推进版本的发布阶段

全面发布

选择此选项会向所有目标国家/地区的所有用户发布您的 Action 项目。

如需以全面发布的方式部署您的 Action,请按以下步骤操作:

  1. 管理版本下,选择要升级到正式版发布的版本。
  2. 点击管理部署

    选择“管理部署”的屏幕截图

  3. 选择部署到生产环境

  4. 选择全面发布

  5. 点击提交

创建新的正式版本(不使用 Alpha 版或 Beta 版测试)

正式版本可以是向所有 Google 助理用户全面发布,也可以是针对特定地区或一定比例的用户分阶段发布。分阶段发布有助于测试 Action 项目的稳定性。最好向一小部分用户发布,然后逐步增加,直至达到 100% 的用户为止。这样,您就可以在面向整个用户群发布应用之前解决错误。

分阶段发布

通过分阶段发布的方式,开发者可以先面向一部分用户发布应用,然后再逐步向所有用户推出,从而管理正式版。您可以逐步增加部署的区域或用户百分比。

如需分阶段发布您的 Action,请按以下步骤操作:

  1. 在 Actions 控制台中,点击 Deploy > Release
  2. 点击开始使用新版本

    开始发布新版本的屏幕截图

  3. 选择正式版

  4. 如果系统提示您完成操作审核要求核对清单中的必要步骤,

  5. 为版本选择语言(如果适用于您的项目)。

  6. 选择分阶段发布

  7. 点击选择发布类型

  8. 选择指定地理位置用户百分比。如需详细了解此选项,请参阅按指定位置发布按用户群百分比发布

    选择分阶段发布模式的屏幕截图

  9. 点击提交

按指定位置发布

选择此选项会将您的 Action 项目发布到您选择的国家或地区。

如需按地点发布您的 Action,请按以下步骤操作:

  1. 点击选择国家或地区,然后选中您的发布版本的目标地区对应的复选框。
  2. 点击提交

按用户群百分比发布

此选项会将您的 Action 发布给一定比例的随机选择的用户。

如需面向一定比例的用户发布您的 Action,请按以下步骤操作:

  1. 点击用户百分比
  2. 选择您要向其发布 Action 的用户所占的百分比。

    选择用户百分比的屏幕截图

  3. 点击提交

全面发布

选择此选项会向所有目标国家/地区的所有用户发布您的 Action 项目。

如需以全面发布的方式部署您的 Action,请按以下步骤操作:

  1. 在 Actions 控制台中,点击 Deploy > Release
  2. 点击开始使用新版本

    开始发布新版本的屏幕截图

  3. 选择正式版

  4. 如果系统提示您完成操作审核要求核对清单中的必要步骤,

  5. 为版本选择语言(如果适用于您的项目)。

  6. 选择全面发布

  7. 点击提交

正式版提交后,会显示在管理版本部分中。

修改或取消部署版本

将 Action 提交到发布渠道后,您仍可以进行更改。您可以测试当前版本、撤消版本审核、查看版本详情、管理部署、取消部署和升级发布阶段。您还可以在此查看过往版本的详细信息。

查看和修改发布版本

如需查看版本详情或更改 Action 的版本,请按以下步骤操作:

  1. 管理版本下,选择版本名称下的版本。
  2. 选择修改发布管理部署查看更多

推进版本的发布阶段

如需推进您的 Action 的发布阶段,请按以下步骤操作:

  1. 管理版本下,选择要升级的版本。
  2. 点击修改发布按钮。
  3. 更改发布。例如,您可以将用户群从 5% 提升到 20%。
  4. 点击提交

从生产环境中取消部署

  • 如果您需要离线进行分阶段发布,请点击管理版本下的修改发布。您可以清除所有区域或选择 0%,具体取决于您是按位置还是按用户群百分比进行发布。
  • 如需取消部署已全面发布(100% 用户群)的 Action,请点击管理版本下的管理部署按钮,然后选择从生产环境中取消部署