高级 API

借助 Google Ads 脚本中的高级 API,开发者可以连接到某些公共 Google API,所需设置比使用其 HTTP 接口少。您可以像使用脚本的内置服务一样使用这些 API,它们还提供自动补全和自动授权等便利功能。

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

可用的高级 API

Google Analytics
您可以使用 Google Analytics 跟踪网站的流量,并相应地调整广告系列出价。如果您将 Google Analytics 媒体资源与 Google Ads 账号相关联,还可以分析网站上的客户活动。 这些信息可让您了解 Google Ads 为您的网站带来了多少流量或销售额,并帮助您改进广告和网站。如需详细了解如何关联 Analytics 和 Google Ads 账号,请参阅 为网站和/或应用设置 Analytics 帮助中心指南。
Google BigQuery
您可以将大量数据加载到 Google Cloud Storage 中,然后使用 Google BigQuery 查询这些数据。例如,您可以加载过去 10 年的公共天气数据,然后在脚本中查询某个地区的平均温度,该脚本会使用这些信息来调整出价。另一个用途是对账号的多年效果数据进行数字运算。
Google 日历
您的脚本可以为未来的任务创建活动(例如,在今天起 2 周后运行广告系列的效果报告),也可以根据您在日历中创建的条目执行操作(例如,在特定日期启用广告系列)。
Google 幻灯片
您的脚本可以将广告系列详细信息或统计信息导出到 Google 幻灯片,以便以可演示的格式发布此类信息。
Google Tasks
您的脚本可以为未来的任务创建提醒列表(例如,在今天起 2 周后运行广告系列的效果报告),也可以根据您在提醒列表中创建的条目执行操作(例如,在特定日期启用广告系列)。
Merchant API
您的脚本可以使用 Merchant API 上传和管理商品信息,以及管理 Google Merchant Center 账号。在脚本中,这对于检查商品详情以及将指定商品与特定广告相关联非常有用。Merchant API 具有子 API,可以在高级 API 对话框中单独启用。如需详细了解如何关联 Google Merchant Center 账号,请参阅 注册成为开发者指南。
购物内容
您的脚本可以使用 Google Content API for Shopping 上传和管理商品信息,以及管理 Google Merchant Center 账号。在脚本中,这对于检查商品详情以及将指定商品与特定广告相关联非常有用。注意 :Content API for Shopping 将于 2026 年 8 月 18 日停用。请改用上一部分中介绍的 Merchant API。
YouTubeYouTube 数据分析
您可以检索和更新视频、播放列表等,以及视频的效果数据,以便做出出价决策。

启用高级 API

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

点击保存 以保存所选内容并返回到脚本编辑器。系统会为您的脚本启用新的 API,并且这些 API 会显示在自动补全列表中。

其他注意事项

使用高级 API 时,需要注意以下几点。

依赖项

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

权限

访问 API 时,脚本会使用授权该脚本的用户的权限。请确保授权该脚本的用户拥有访问脚本所需的所有数据的必要权限。如果您使用的是 Google Analytics API,请验证授权该脚本的用户是否拥有访问 Analytics 账号的必要权限。

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

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

启用高级 API

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

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

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