高级 API

借助 Google Ads 脚本中的高级 API，开发者可以连接到某些公开的 Google API，而无需像使用其 HTTP 接口那样进行繁琐的设置。您可以像使用脚本的内置服务一样使用这些 API，它们提供相同的便利，例如自动补全和自动授权。

请参阅我们的代码段页面，查看一些展示如何使用这些 API 的示例。

可用的高级 API

Google Analytics
注意：高级 API 对话框中的 Analytics 高级 API 针对的是已停用的 Universal Analytics v3 API，向其发出的请求会失败。Google Ads 脚本不支持 Google Analytics 4 AnalyticsData 或 AnalyticsAdmin 高级服务。如需通过脚本查询 Google Analytics 4 数据，请使用 UrlFetchApp 服务和 OAuth 2.0 向 Google Analytics Data API 发送 HTTPS 请求。您还可以将 Google Analytics 4 媒体资源与 Google Ads 账号相关联，直接共享网站和应用转化数据。如需查看设置说明，请参阅 Google Analytics 设置指南。
Google BigQuery
您可以将大量数据加载到 Google Cloud Storage 中，然后使用 Google BigQuery 查询这些数据。例如，您可以加载过去 10 年的公共天气数据，然后在脚本中查询某个地区的平均温度，并使用该信息来调整出价。另一个用途是对您账号多年来的效果数据进行数字运算。
Google 日历
您的脚本可以为未来的任务创建活动（例如，从今天起 2 周后为您的广告系列生成效果报告），也可以根据您在日历中创建的条目执行操作（例如，在特定日期启用广告系列）。
Google 幻灯片
您的脚本可以将广告系列详细信息或统计信息导出到 Google 幻灯片，以便以易于展示的格式发布此类信息。
Google Tasks
您的脚本可以为未来的任务创建提醒列表（例如，从今天起两周后为您的广告系列生成效果报告），也可以根据您在提醒列表中创建的条目执行操作（例如，在特定日期启用广告系列）。
Merchant API
您的脚本可以使用 Merchant API 上传和管理商品详情，以及管理 Google Merchant Center 账号。在脚本中，这有助于检查商品详情并将指定商品与特定广告相关联。Merchant API 包含多个 sub-API，这些 sub-API 可以在高级 API 对话框中单独启用。如需详细了解如何关联 Google Merchant Center 账号，请参阅注册为开发者指南。
带货内容
您的脚本可以使用 Google Content API for Shopping 来上传和管理商品详情，以及管理 Google Merchant Center 账号。在脚本中，这有助于检查商品详情并将指定商品与特定广告相关联。注意：Content API for Shopping 将于 2026 年 8 月 18 日弃用。请改用上一部分中所述的 Merchant API。
YouTube 和 YouTube 数据分析
您可以检索和更新视频、播放列表等内容，以及视频的效果数据，以便做出出价决策。

启用高级 API

如需查看哪些 Google API 可作为高级 API 使用，请点击顶部编辑器栏中的高级 API，以显示高级 API 对话框。选择要启用的 API。

点击保存以保存您的选择并返回脚本编辑器。系统会为您的脚本启用新 API，并将其添加到自动补全列表中。

其他注意事项

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

依赖项

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

权限

访问高级 API 时，脚本会使用授权该脚本的用户的权限。授权用户必须拥有对脚本所需的所有数据的必要访问权限。例如，如需使用 BigQuery 高级 API，授权用户必须拥有目标 Google Cloud 项目和 BigQuery 数据集的必要权限。

2019 年 5 月之前创建的脚本的注意事项

对于 2019 年 5 月之前创建的脚本，您可能需要在脚本关联的 Google Cloud 云项目中手动启用相关 API。如果您在高级 API 对话框中看到指向 Google Cloud 控制台的链接，则表示您的脚本受到了影响。

启用高级 API

对于 2019 年之前的脚本，您需要手动启用要在脚本中使用的每个高级 API：

  1. 点击高级 API 按钮。在以下对话框窗口中，点击指向 Google Cloud 控制台的链接。
  2. 如果尚未选择您的项目，请从“项目”下拉列表中选择该项目。
  3. 在搜索栏中输入 API 名称，搜索要在脚本中使用的 API。
  4. 从搜索结果中选择该 API，然后点击后续页面上的“启用”按钮。

如果创建脚本的用户后来从账号中移除，则任何尝试访问该脚本的新用户都会收到提示，要求再次启用高级 API 依赖项，并重新授权该脚本。