此页面由 Cloud Translation API 翻译。

高级 API

借助 Google Ads 脚本中的高级 API，经验丰富的开发者可以连接到某些公共 Google API，所需设置比使用其 HTTP 接口少。您使用这些 API 的方式与使用脚本的内置服务非常相似，它们提供的便利功能（例如自动补全和自动授权）也与内置服务相同。

高级 API 的可能用途

Google Analytics: 您可以使用 Google Analytics 跟踪流量到达您的网站的情况，并相应地调整广告系列出价。如果您将 Google Analytics 媒体资源与 Google Ads 账号相关联，还可以分析自己网站上的客户活动。这些信息可让您了解 Google Ads 为您的网站带来了多少流量或销售额，并帮助您改进广告和网站。您可以访问我们的帮助中心，详细了解如何将 Google Analytics 账号与 Google Ads 账号相关联。
Google BigQuery: 您可以将大量数据加载到 Google Cloud Storage，然后使用 Google BigQuery 查询这些数据。例如，您可以加载过去 10 年的公开天气数据，然后在脚本中查询某个区域的平均温度，并使用这些信息来调整出价。另一种用途是，对账号数年内的效果数据进行数据分析。
YouTube 和 YouTube 分析工具: 您可以检索和更新视频、播放列表等内容以及视频的效果数据，以便做出出价决策。
Google 日历: 您的脚本可以为未来的任务创建活动（例如，在今天之后 2 周为您的广告系列生成效果报告），也可以根据您在日历中创建的条目执行操作（例如，在特定日期启用广告系列）。
购物内容: 您的脚本可以在 Apps Script 中使用 Google Content API for Shopping。借助此 API，Google Merchant Center 用户可以上传和管理商品详情，以及管理 Merchant Center 账号。在脚本中，这对于检查商品详情和将特定商品关联到特定广告非常有用。
Google Tasks: 您的脚本可以为未来的任务创建提醒列表（例如，在 2 周后为您的广告系列生成效果报告），或根据您在提醒列表中创建的条目执行操作（例如，在特定日期启用广告系列）。
Google 幻灯片: 您的脚本可以将广告系列详情或统计信息导出到 Google 幻灯片，以便以可呈现的格式发布此类信息。

启用高级 API

如需查看哪些 Google API 可用作高级 API，请点击顶部编辑器栏中的 Advanced APIs（高级 API）按钮。

此时将出现高级 API 对话框。勾选您要启用的 API。

接下来，点击 Google API 控制台链接，在控制台中打开 API 控制台页面，其中包含与您的脚本关联的项目；或者，如果尚未选择您的项目，请从“项目”下拉列表中选择该项目。在搜索栏中输入 API 名称，搜索您要在脚本中使用的 API。

在搜索结果中，选择相应 API，然后在随后出现的页面上选择启用；如果您看到停用按钮，则表示此 API 已启用。对每个要启用的 API 重复此操作。

如需查看为项目启用的 API 列表，请选择信息中心页面。验证您要为脚本使用的所有高级 API 是否已列出。

现在，关闭“高级 API”对话框，返回到编辑器。系统会为您的脚本启用新 API，并将其添加到自动补全列表中。

可用的 API

您可以使用以下 API：

API 名称	文档
Google Analytics	https://developers.google.com/apps-script/advanced/analytics
Google BigQuery	https://developers.google.com/apps-script/advanced/bigquery
Google 日历	https://developers.google.com/apps-script/advanced/calendar
Google 幻灯片	https://developers.google.com/apps-script/advanced/slides
Google Tasks	https://developers.google.com/apps-script/advanced/tasks
购物内容	https://developers.google.com/apps-script/advanced/shopping-content
YouTube	https://developers.google.com/apps-script/advanced/youtube
YouTube 数据分析	https://developers.google.com/apps-script/advanced/youtube-analytics

您还可以参阅我们的代码段页面，查看有关如何使用这些 API 的一些示例。

最后的注意事项

使用高级 API 时，请注意以下几点。

项目 ID

每个 Google Ads 脚本都有一个关联的 Google Cloud Platform 项目 ID（也称为项目编号）。您可以通过在 Advanced APIs 对话框中打开 Google API 控制台页面，找到脚本的项目编号。此项目 ID 会在您创建脚本时创建，并与创建 Google Ads 脚本的用户相关联。如果创建脚本的用户后来从账号中移除，则尝试访问该脚本的用户会收到重新授权脚本并重新设置高级 API 依赖项的提示。系统还会创建一个新的 Google 开发者项目 ID，并且您需要重新设置高级 API，如本文档前面部分所述。

依赖项

只有在账号中创建脚本的用户才能更改该脚本的高级 API 依赖项。

权限

在访问 API 时，脚本会使用授权脚本的用户的权限。确保授权脚本的用户对所使用的所有高级 API 以及脚本所需的数据具有必要的访问权限。如果您使用的是 Google Analytics API，请确保授权脚本的用户对要访问的 Google Analytics 账号拥有必要的权限。

条款及条件

每种高级 API 都可能有自己的条款及条件，您应在 Google API 控制台中启用 API 时接受这些条款及条件。

配额

大多数高级 API 都有一个与之关联的每日免费配额。脚本超出此配额后，该 API 将停止运行，直到您请求更多数据或免费配额补充完毕。您可以通过以下方式监控脚本使用的配额：从高级 API 对话框中为脚本打开 Google API 控制台。Google API 控制台还提供了一种为 API 申请更多配额的方法。

结算

某些高级 API 需要您付费才能使用。这些付款是通过与您的脚本关联的 Google Cloud Platform 项目进行管理的，而不是通过 Google Ads 进行管理。如需详细了解如何为脚本的 Google Cloud Platform 项目启用结算功能，请参阅我们的文档。