与使用 HTTP 接口相比，Apps 脚本中的高级服务可让有经验的开发者通过较少的设置连接到某些公共 Google API。高级服务本质上是这些 Google API 的瘦封装容器。它们的运作方式与 Apps 脚本的内置服务非常相似 - 例如，它们提供自动补全功能，而 Apps 脚本会自动处理授权流程。但是，您必须先启用高级服务，然后才能在脚本中使用该服务。
如需了解哪些 Google API 可作为高级服务提供，请在参考文档中查找高级 Google 服务部分。如果您想要使用未作为高级服务提供的 Google API，只需像连接到任何其他外部 API 一样连接到该 API。
高级服务还是 HTTP？
每项高级 Google 服务都与一个公共 Google API 相关联。在 Apps 脚本中，您可以通过高级服务或直接使用 UrlFetch 发出 API 请求来访问这些 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 请求标头，例如日历高级服务。
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 脚本参考部分的每个高级服务指南中提供了指向这些支持说明的链接。