Apps 脚本中的高级服务可让经验丰富的开发者连接到某些公共 Google API，所需设置比使用其 HTTP 接口少。高级服务实际上是这些 Google API 的精简封装容器。它们的工作方式与 Apps 脚本的内置服务非常相似，例如，它们提供自动补全功能，并且 Apps 脚本会自动处理授权流程。 不过，您必须先启用高级服务，然后才能在脚本中使用该服务。
如需查看哪些 Google API 可作为高级服务使用，请在参考中查找高级 Google 服务部分。如果您想使用未作为高级服务提供的 Google API，只需像连接任何其他外部 API 一样连接到该 API 即可。
高级服务还是 HTTP？
每项高级 Google 服务都与一个公开的 Google API 相关联。
在 Apps 脚本中，您可以通过高级服务访问这些 API，也可以直接使用 UrlFetch 发出 API 请求。
如果您使用高级服务方法，Apps 脚本会处理授权流程并提供自动补全支持。不过，您必须先启用高级服务，然后才能使用它。此外，某些高级服务仅提供 API 中提供的部分功能。
如果您使用 UrlFetch 方法直接访问 API，则实际上是将 Google API 视为外部 API。使用此方法可以利用 API 的所有方面。不过，您需要自行处理 API 授权。您还必须构建任何所需的标头并解析 API 响应。
一般来说，最好尽可能使用高级服务，只有在高级服务无法提供所需功能时才使用 UrlFetch 方法。
要求
您必须满足以下要求，才能使用高级服务：
- 您必须在脚本项目中启用高级服务。
您必须确保在脚本使用的 Cloud Platform (GCP) 项目中启用与高级服务对应的 API。
如果您的脚本项目使用 2019 年 4 月 8 日或之后创建的默认 GCP 项目，则在您启用高级服务并保存脚本项目后，系统会自动启用该 API。如果您尚未同意 Google Cloud 和 Google API 服务条款，系统可能还会要求您同意这些条款。
如果脚本项目使用标准 GCP 项目或旧版默认 GCP 项目，您必须在 GCP 项目中手动启用高级服务对应的 API。您必须拥有 GCP 项目的编辑权限才能进行此更改。
如需了解详情，请参阅 Cloud Platform 项目。
启用高级服务
如需使用高级 Google 服务，请按以下说明操作：
- 打开 Apps 脚本项目。
- 点击左侧的编辑器图标 。
- 在左侧，点击服务旁边的添加服务图标 。
- 选择一项高级 Google 服务，然后点击添加。
启用高级服务后，该服务会显示在自动补全功能中。
方法签名是如何确定的
高级服务通常使用与相应公共 API 相同的对象、方法名称和参数，不过方法签名会经过转换，以便在 Apps 脚本中使用。脚本编辑器的自动补全功能通常会提供足够的信息来帮助您入门，但以下规则说明了 Apps 脚本如何从公共 Google API 生成方法签名。
对 Google API 的请求可以接受各种不同类型的数据，包括路径参数、查询参数、请求正文和/或媒体上传附件。某些高级服务还可以接受特定的 HTTP 请求标头（例如，Calendar 高级服务）。
Google Apps 脚本中对应的方法签名具有以下实参：
- 请求正文（通常是资源），以 JavaScript 对象的形式呈现。
- 路径或必需参数，以单个实参的形式提供。
- 媒体上传附件，以
Blob实参的形式。 - 可选参数，以 JavaScript 对象形式表示，用于将参数名称映射到值。
- HTTP 请求标头，以 JavaScript 对象形式将标头名称映射到标头值。
如果方法在给定类别中没有任何项，则会省略签名中的相应部分。
不过，也有一些需要注意的特殊例外情况：
- 对于接受媒体上传的方法，系统会自动设置参数
uploadType。 - Google API 中名为
delete的方法在 Apps 脚本中名为remove，因为delete是 JavaScript 中的保留字。 - 如果高级服务配置为接受 HTTP 请求标头，并且您设置了请求标头 JavaScript 对象，那么您还必须设置可选参数 JavaScript 对象（如果您不使用可选参数，则将其设置为空对象）。
支持高级服务
高级服务只是一个精简的封装容器，可用于在 Apps 脚本中使用 Google API。因此，在使用这些服务时遇到的任何问题通常都是底层 API 的问题，而不是 Apps 脚本本身的问题。
如果您在使用高级服务时遇到问题，应按照相应底层 API 的支持说明报告问题。在 Apps 脚本的参考部分中，每个高级服务指南都提供了指向这些支持说明的链接。