限制

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

执行时间限制

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

广告管理器脚本

广告管理器脚本通常最多可执行 30 分钟，超过此时间限制就会被取消。不过，如果广告管理工具脚本使用 executeInParallel 方法并行处理帐号，并指定回调方法，则脚本在被取消之前最多可执行最多 60 分钟。如下图所示，其中 processAccount 是并行函数，allFinished 是调用 executeInParallel 时的回调方法。

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

实体数量限制

Google Ads 账号脚本

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

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

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

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

经理帐号脚本

  • 由 Google Ads 管理器脚本处理的每个帐号都会获得自己的配额（如上所列）。

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

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

批量上传限制

  • 上传文件的上限为 50MB 和 100 万行，如果超出这些限制，将在提交时拒绝。

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

Google 服务的配额

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

获得授权的脚本

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

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

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

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