限制

本页列出了您需要了解的有关 Google Ads 脚本的各种限制。这些限制随时可能发生变化，恕不另行通知；请确保您的脚本可灵活调整，并包含错误处理。

执行时间限制

用于广告客户账户的 Google Ads 脚本最多可执行 30 分钟，超过此时间限制就会被取消。在脚本被取消之前做出的任何更改都会得到应用。

Ad Manager 脚本

Ad Manager 脚本通常的执行时长上限为 30 分钟，之后便会被取消。不过，如果 Google Ads 经理账号脚本使用 executeInParallel 方法并行处理账号，并指定了回调方法，则在被取消之前，其执行时间最长可达 60 分钟。下图对此进行了说明，其中 processAccount 是并行函数，allFinished 是调用 executeInParallel 时的回调方法。

在脚本被取消之前做出的任何更改都会得到应用。

实体数量限制

Google Ads 账号的脚本

  • 单个迭代器默认最多可返回 5 万个结果。您可以通过对选择器调用 withLimit() 来修改此设置。

  • 单个选择器在 selector.withIds() 中最多可以处理 1 万个 ID。 如果指定了 10,000 个或更多 ID，selector.get() 将抛出运行时错误。同样，使用 ID 列表指定 Id IN [LIST] 条件

    10,000 会导致运行时错误。

  • 记录输出达到 100KB 后会被截断。如果出现这种情况，系统将记录一次警告。

经理账号的脚本

  • 由 Ad Manager 脚本处理的每个账号都会获得自己的配额（如上文所述）。

  • 使用 executeInParallel 方法时，脚本最多可处理 50 个账号。

  • executeInParallel 中的 processAccount 方法最多可返回 10MB 的数据。

批量上传限制

  • 上传文件大小不得超过 50MB 且行数不得超过 100 万行，如果超出这些限制，系统会在提交时拒绝该文件。

  • 上传作业在两小时后即为超时，将停止处理来自上传文件的任何剩余数据。

Google 服务的配额

基础的 Google Apps 脚本服务对某些功能有每日配额和硬限制。请参阅这些配额及随附的异常消息的列表。

获得授权的脚本

使用 OAuth2 对脚本进行授权。每个账号最多只能有 250 个已获授权的脚本。一旦超过此限额，之前获得授权的一个脚本将被取消授权。这种情况只是暂时的，该脚本在下一次打开时可以重新获得授权。

如果您经常遇到此限制，则应考虑使用多个用户账号来授权不同的脚本集。

视频广告系列和购物广告系列

标准广告系列选择器 (AdsApp.campaigns().get()) 会从结果中滤除视频广告系列和购物广告系列。请改用专用广告系列选择器：