最佳实践和限制

使用 BatchJobService 时，请考虑以下准则。

提高吞吐量

  • 最好是少量的大型作业，而不是许多小型作业。

  • 按操作类型对已上传的操作进行排序。例如，如果您的作业包含用于添加广告系列、广告组和广告组条件的各项操作，请在上传时对这些操作进行排序，以便先执行所有广告系列操作，然后执行所有广告组操作，最后执行所有广告组条件操作。

  • 在同一类型的操作中，按父资源对操作进行分组可以提高性能。例如，如果您有一系列 AdGroupCriterionOperation 对象，按广告组对操作进行分组会比混合影响不同广告组中广告组条件的各种操作更高效。

批量拆分的原子性

Google Ads API 可能会将提交的批处理作业中的操作拆分为较小的子批次进行处理。如果您未将相关操作（例如 AssetGroup 和 AdGroup 中的列表组修改）在批处理作业中连续分组，Google Ads API 可能会将这些操作拆分为不同的子批处理。这种分离可能会导致整个修改失败，或者使账号处于不一致的状态。

逻辑分组

AssetGroupListingGroupFilterOperation 管理 AssetGroup 中的商品信息组，这在效果最大化广告系列中很常见。 AdGroupCriterionOperation 用于管理 AdGroup 中的商品详情组，这在标准购物广告系列中很常见。两者都用于定义商品定位。如果您所做的更改会影响两个上下文中的商品定位层次结构，请在批处理作业中连续分组这些操作，以确保它们一起应用。

数据一致性

为保持数据一致性并防止部分更新，请将相关商品详情组操作连续添加到批量作业中。这种排序方式有助于通过 API 的批次拆分逻辑将它们分组为原子子批次，从而防止您的账号处于不一致的状态。

避免并发问题

  • 为同一账号提交多个并发作业时，请尽量减少作业同时对同一对象进行操作的可能性，同时保持较大的作业规模。许多未完成的作业（状态为 RUNNING）尝试更改同一组对象，这可能会导致类似死锁的情况，从而导致严重减速，甚至作业失败。

  • 请勿在同一作业中提交会使同一对象发生变化的多项操作，因为结果可能无法预测。

以最佳方式检索结果

  • 请勿过于频繁地轮询作业状态，否则可能会遇到速率限制错误。

  • 每页检索结果不得超过 1,000 条。由于负载或其他因素，服务器返回的数量可能少于此值。

  • 结果顺序将与上传顺序相同。

其他使用指南

  • 您可以设置批处理作业在被取消之前允许运行的时长上限。创建新的批处理作业时，请将 metadata.execution_limit_seconds 字段设置为您偏好的时间限制（以秒为单位）。如果未设置 metadata.execution_limit_seconds，则没有默认时间限制。

  • 建议每个 AddBatchJobOperationsRequest 中添加的操作不超过 1,000 个，并使用 sequence_token 将其余操作上传到同一作业。根据操作的内容，单个 AddBatchJobOperationsRequest 中的操作过多可能会导致 REQUEST_TOO_LARGE 错误。您可以通过减少操作次数并重试 AddBatchJobOperationsRequest 来处理此错误。

限制

  • 每个 BatchJob 最多支持 100 万次操作。

  • 每个账号最多可同时有 100 个有效或待处理的作业。

  • 系统会自动移除存在时长已超过 7 天的待处理作业。

  • 自 v22 起，每个 AddBatchJobOperations 请求的变异操作数上限为 10,000。

  • 自 v22 起，对于 ListBatchJobResultsRequest 中的 page_size 字段：

  • 每个 AddBatchJobOperationsRequest 的大小上限为 10,484,504 字节。如果超出此限制，您将收到 INTERNAL_ERROR。您可以在提交请求之前确定其大小，并在请求过大时采取适当的措施。

    Java

    
static final int MAX_REQUEST_BYTES = 10_484_504;

... (code to get the request object)

int sizeInBytes = request.getSerializedSize();

    Python

    
from google.ads.googleads.client import GoogleAdsClient

MAX_REQUEST_BYTES = 10484504

... (code to get the request object)

size_in_bytes = request._pb.ByteSize()

    Ruby

    
require 'google/ads/google_ads'

MAX_REQUEST_BYTES = 10484504

... (code to get the request object)

size_in_bytes = request.to_proto.bytesize

    PHP

    
use Google\Ads\GoogleAds\V16\Resources\Campaign;

const MAX_REQUEST_BYTES = 10484504;

... (code to get the request object)

$size_in_bytes = $campaign->byteSize() . PHP_EOL;

    .NET

    
using Google.Protobuf;
const int MAX_REQUEST_BYTES = 10484504;

... (code to get the request object)

int sizeInBytes = request.ToByteArray().Length;

    Perl

    
use Devel::Size qw(total_size);
use constant MAX_REQUEST_BYTES => 10484504;

... (code to get the request object)

my $size_in_bytes = total_size($request);
上一页
产品信息组过滤条件