迁移

新的 Google Ads 脚本基础架构以 Google Ads API 为基础。由于该 API 的架构不同,您可能需要更新现有脚本。我们已尽一切努力确保尽可能高的向后兼容性,因此这些更改应该很小。

报告

许多 AWQL 报告仍可继续使用。在后台使用新的基础架构时,脚本会将您的 AWQL 查询转换为 GAQL(Google Ads API 的新查询语言),针对新的后端运行,然后将结果转换回 AWQL 报告最初使用的格式。使用 GAQL 的查询将按原样传递。

鉴于此开销,我们建议您浏览脚本并尽可能将 AWQL 查询更新为 GAQL。您可以使用查询迁移工具,该工具采用与脚本相同的逻辑来确定指定 AWQL 查询的 GAQL 查询,也可以使用交互式查询构建器来构建查询。

以下是对从 AWQL 到 GAQL 的自动转换的一些限制:

  • 并非所有 AWQL 查询都能完全转换为 GAQL 查询。在这些情况下,系统会记录一条错误消息,其中详细说明了哪里出了问题,以帮助您手动解决这些问题。
  • 并非所有来自 AWQL 的报告类型在 GAQL 中都受支持。
  • GAQL 不支持“展示次数为零的行”。指定报告应包含零展示会导致错误。
  • 一些不明确的字段无法在过滤条件中使用。例如,“标题”可以引用任意数量的不同广告字段。
  • 某些字段可能会以不同的格式返回结果,例如,将一个结果分解为多列。

整理选择器

使用脚本提取资源时,通常使用 withConditionorderBy 调用对迭代器中的结果进行限制或排序。这些调用中的字段现在使用新的 Google Ads API 名称。例如,要按广告系列名称进行过滤,您应该使用以下代码:

.withCondition('CampaignName = "SOME_CAMPAIGN_NAME"')

现在,您应尽可能为这些条件使用新的字段名称:

.withCondition('campaign.name = "SOME_CAMPAIGN_NAME"')

尽管如此,我们已尽力将旧名称映射到新名称,因此如果您的脚本仍使用 CampaignName,系统会在运行时自动将其替换为 campaign.name,以确保脚本仍可正常运行。如果您在使用旧样式名称时遇到任何问题,请更新脚本以使用新的样式名称,作为问题排查步骤的第一步。

限制

许多限制与在旧基础架构上相同,在此处所做的更改通常有助于提高性能。

  • 时间限制相同。脚本可能执行 30 分钟。
  • 默认情况下,单个迭代器会返回 50,000 个实体,但您可以覆盖这一限制。之前,这 50,000 个的上限无法自定义。
  • 单个选择器最多可以处理 10,000 个 ID(保持不变)。
  • 新的基础架构对单个脚本中可以处理的实体数量没有限制。之前的上限是 250,000 次。
  • 新的基础架构对每次执行可创建的关键字或广告数量没有限制。之前的上限是 250,000 次。
  • 日志记录输出在 100kb 时被截断(保持不变)。
  • Apps 脚本服务( DataprepApp、MailApp 等)的配额保持不变。
  • 系统会强制执行 Google Ads 配额,就像您在使用 API 一样。也就是说,您的脚本将受 API 速率限制,但这可让您更灵活地访问更多报告,或在每次执行时进行更多更改。

其他变更

ExecutionInfo 不再公开 getRemainingCreateQuota()getRemainingGetQuota(),因为这些配额不再适用于新版。