高级 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 周后运行广告系列的效果报告),或者根据您在日历上创建的条目执行操作(例如,在特定日期启用广告系列)。
Shopping Content
您的脚本可以在 Apps 脚本中使用 Google Content API for Shopping。借助此 API,Google Merchant Center 用户能够上传和管理自己的商品详情,以及管理其 Merchant Center 帐号。在脚本中,这对于检查商品详情以及将特定商品关联到特定广告非常有用。
Google Tasks
您的脚本可以为未来的任务创建提醒列表(例如,从今天起两周后运行广告系列效果报告),或者根据您在提醒列表中创建的条目来执行操作(例如,在特定日期启用广告系列)。
Google 幻灯片
您的脚本可以将广告系列详细信息或统计信息导出到 Google 幻灯片,以适合演示的格式发布这些信息。

启用高级 API

如需查看哪些 Google API 可用作高级 API,请点击编辑器顶部栏上的高级 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
Shopping Content 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(也称为项目编号)。您可以从高级 API 对话框中打开 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 项目启用结算功能。