新的 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 不支持“展示次数为零的行”。指定报告应包含零展示会导致错误。
- 一些不明确的字段无法在过滤条件中使用。例如，“标题”可以引用任意数量的不同广告字段。
- 某些字段可能会以不同的格式返回结果，例如，将一个结果分解为多列。
整理选择器
使用脚本提取资源时，通常使用 withCondition 和 orderBy 调用对迭代器中的结果进行限制或排序。这些调用中的字段现在使用新的 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()，因为这些配额不再适用于新版。