限制

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

执行时间限制

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

Ad Manager 脚本

广告管理工具脚本通常可以执行最长 30 分钟，之后会被取消。不过，如果 Google Ads 脚本使用 executeInParallel 方法并行处理账号，并指定了回调方法，则该脚本最多可以执行 60 分钟，然后会被取消。下图对此进行了说明，其中 processAccount 是并行函数，allFinished 是调用 executeInParallel 时的回调方法。

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

实体数量限制

Google Ads 账号的脚本

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

  • 单个选择器最多可以处理 selector.withIds() 中的 10,000 个 ID。 如果指定的 ID 数量达到或超过 10,000，selector.get() 将抛出运行时错误。同样，指定包含 ID 列表的 Id IN [LIST] 条件

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

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

经理账号的脚本

  • 由 Google Ads 脚本处理的每个账号都会获得自己的配额，如上文所述。

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

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

批量上传限制

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

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

Google 服务的配额

基础的 Google Apps 脚本服务对某些功能有每日配额和硬限制。查看这些配额和随附的例外情况消息的列表。

获得授权的脚本

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

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

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

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