使用高级 API

与使用 HTTP 接口相比,借助 AdWords 脚本中的高级服务,有经验的开发人员进行较少的设置即可连接到某些公开的 Google API。使用这些 API 的方式与使用脚本的内置服务相类似,而且它们也提供了同样的便利功能,如自动完成和自动授权等。

高级 API 的可能用途

Google Analytics(分析)
您可以使用 Google Analytics(分析)来跟踪访问网站的流量,并相应调整广告系列的出价。如果将 Google Analytics(分析)媒体资源与 AdWords 帐户相关联,就可以分析您网站上的用户活动。这些信息可让您了解 AdWords 为您的网站带来了多少流量或销售量,并帮助您优化广告和网站。要详细了解如何关联 Google Analytics(分析)与 AdWords 帐户,请访问我们的帮助中心
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 工作表
您的脚本可以为未来的任务创建提醒列表(例如,在当天起 2 周后运行广告系列的效果报告),或根据您在提醒列表中创建的条目来执行操作(例如,在某个日期启用广告系列)。
Google Prediction
您可以利用历史数据来打造 Google 预测引擎和进行趋势分析。例如,如果您经营一家药店,并且您拥有关于当日天气和感冒药销量的历史数据,那么您可以利用 Google 预测引擎建立一个模型,并利用该模型来预测特定季节的销售额。同样,如果您销售保暖夹克,您就可以利用以往的天气数据和销售数字来建立 Google 预测引擎模型。结合使用该模型和某日的天气预报数据,就可以预测该日的销售额,并相应调整您的出价和预算。

启用高级 API

要查看可以使用哪些作为高级服务提供的 Google API,请点击编辑器顶部菜单栏中的高级 API 按钮。

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

接下来,点击 Google API Console 链接,在控制台中调出 API 管理器页,其中带有与您的脚本相关联的项目(请注意,如果您的项目尚未选定,请从“项目”下拉列表中加以选择)。通过在搜索栏中输入 API 名称,搜索您要在脚本中使用的 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 Fusion Tables https://developers.google.com/apps-script/advanced/fusion-tables
Google Prediction https://developers.google.com/apps-script/advanced/prediction
Shopping Content https://developers.google.com/apps-script/advanced/shopping-content
Google 工作表 https://developers.google.com/apps-script/advanced/tasks
YouTube https://developers.google.com/apps-script/advanced/youtube
YouTube 分析工具 https://developers.google.com/apps-script/advanced/youtube-analytics

您也可以参考我们的代码段页,查看有关如何使用这些 API 的一些示例。

最后的注意事项

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

项目 ID

每个 AdWords 脚本都有一个与之关联的 Google Developer Console 项目 ID(又称为项目编号)。您可以通过在高级 API 对话框中打开 Google Developers Console 页,找到脚本的项目编号。项目 ID 在创建脚本时生成,并且与创建 AdWords 脚本的用户相关联。如果创建脚本的用户后来被从帐户中删除,那么当某个用户试图访问脚本时,系统将提示对脚本重新授权,并重新设置高级 API 的依赖关系。此时还将创建新的 Google Developer 项目 ID,并且需要按照本文前面的说明,重新设置高级 API。

修改高级 API 的依赖关系

只有在帐户中创建脚本的用户才能更改该脚本的高级 API 依赖关系。

脚本权限

访问 API 时,脚本将使用之前已向其授权的用户的权限。对于要使用的所有高级 API,以及脚本需要的数据,请确保向脚本授权的用户拥有所需要的访问权限。如果您要使用 Google Analytics(分析)API,请确保对于要访问的 Google Analytics(分析)帐户,向脚本授权的用户拥有所需权限。

条款及条件

每个高级 API 都可能有自己的条款及条件,您在 Google Developers Console 中启用 API 时必须接受这些条款及条件。

配额

大多数高级 API 都有一个与之关联的每日免费配额。如果您的脚本超出该配额,API 将停止运行,直到您请求其他数据,或免费配额得到重置。您可以在高级 API 对话框中打开脚本的 Google Developers Console,监控脚本的配额使用情况。通过 Google Developers Console,您还可以请求 API 的额外配额。

结算

一些高级 API 可能需要付费使用。此类付款通过与脚本关联的 Google Developers Console 项目进行管理,而不是通过 AdWords 来管理。请参阅我们的文档,详细了解如何启用脚本的 Google Developers Console 项目的结算。

发送以下问题的反馈:

此网页
AdWords Scripts
AdWords Scripts
需要帮助?请访问我们的支持页面