创建和管理部署

Google Apps 脚本项目部署是指可作为 Web 应用、Google Workspace 插件或 API 可执行文件使用的脚本版本。 通过创建和管理部署,您可以迭代代码、跟踪更改并控制用户访问的代码版本。

部署分为两种类型:

  • Head 部署,始终与当前项目代码同步。
  • 版本化部署,可连接到特定的项目版本。

头部部署

头部署是指当前项目代码。创建 Apps 脚本项目时,系统会自动为该项目创建 Head 部署。

Head 部署始终会与最近保存的代码同步。例如,如果您创建了版本化部署,然后修改了代码,则 Head 部署会反映这些更改,而版本化部署则保持不变。

使用 Head 部署来测试代码。请勿将 Head 部署用于公开用途。

每个 Apps 脚本项目只有一个 Head 部署。如需使用 Head 部署,您必须至少拥有对脚本项目的读取权限。

有版本编号的部署

版本化部署可提供特定版本的项目代码。 这样,您在对代码进行更改和改进时,用户可以继续使用正常运行的版本。

发布供公众使用的应用时,请务必使用版本化部署。您可以同时拥有多个有效的版本化部署。

重要提示:您无法转移版本化部署的所有权。如果您转移脚本项目的所有权,现有已发布版本的部署的所有者不会发生变化。如果管理员删除部署所有者的账号,其部署可能会遇到脚本错误。

创建版本化部署

如需部署插件、编辑器插件、Chat 应用或 API 可执行文件的版本,您必须先将 Apps 脚本的 Google Cloud 项目关联从默认项目切换到标准项目

如需创建版本化部署,请执行以下操作:

  1. 打开 Apps 脚本项目。 <<../_common/snippets/create-new-deployment.md>>

每个新部署都可以作为库进行共享。如果您将脚本作为库进行共享,部署说明将对库用户可见。

查看已纳入版本控制的部署

如需查看 Apps 脚本项目的部署,请依次点击顶部的部署 > 管理部署

如需查看特定版本的代码,请参阅查看旧版本

修改版本化部署

您可以修改版本化部署,以更改其说明或版本。如需修改部署,请执行以下操作:

  1. 打开 Apps 脚本项目。
  2. 依次点击部署 > 管理部署
  3. 选择有效部署,然后点击修改图标
  4. 进行更改,然后点击部署

如需修改已归档的部署,请重新部署该部署,然后按照上述步骤操作。

如需部署对项目代码的更改,请创建新版本并修改部署以使用该版本。部署会自动为所有用户使用新版本。

查找部署 ID

每个部署都有一个关联的字符串 ID。如需查找此 ID,请执行以下操作:

  1. 打开 Apps 脚本项目。
  2. 在右上角,依次点击部署 > 管理部署
  3. 选择一个有效部署以查找其 ID。

部署 ID 仅显示在有效部署中。

测试部署

测试部署的方法取决于您构建的应用类型。

Google Workspace 加购项

如需测试插件部署,请参阅 测试插件

编辑器插件

如需测试编辑器插件部署,请参阅 测试编辑器插件

Web 应用

如需测试 Web 应用部署,请参阅 测试 Web 应用部署

Google Chat 应用

如需测试 Google Chat 应用部署,请 创建脚本的版本化部署,以访问其部署 ID。

获得部署 ID 后,在 Chat API 配置中指定该 ID,然后按照步骤测试互动功能

可执行的 API

如需测试 API 可执行部署,请创建版本化部署。创建部署后,请按以下步骤操作:

  1. 在 Apps 脚本项目的右上角,依次点击部署 > 测试部署
  2. 在“选择类型”旁边,依次点击 启用部署类型> API 可执行文件
  3. 复制并使用该网址来测试 API 可执行程序的部署。

归档版本化部署

您无法删除已纳入版本控制的部署。您可以改为封存这些应用。

如需归档已纳入版本控制的部署,请执行以下操作:

  1. 打开 Apps 脚本项目。
  2. 依次点击部署 > 管理部署
  3. 选择相应部署,然后点击归档部署图标

重新部署已归档的部署

  1. 打开 Apps 脚本项目。
  2. 在右上角,依次点击部署 > 管理部署
  3. 已归档下,选择相应部署,然后依次点击修改图标 > 部署