批处理

虽然大多数服务都提供同步 API，需要您发出请求，然后等待响应，但 BatchJobService 提供了一种方法，可对多个服务执行批量操作，而无需同步等待操作完成。

与服务专用更改操作不同，BatchJobService 中的单个作业可以针对广告系列、广告组、广告、条件、标签和 Feed 项的混合集合进行操作。提交的作业会并行运行，并且 BatchJobService 会自动重试因瞬时错误（例如速率限制错误）而失败的操作。Google Ads API 仍会按照API 操作统计说明，将每项操作计入您的每日操作限制。

借助 BatchJobService，您还可以在请求中使用临时 ID，以便在单个作业中提交依赖操作。

注意： 使用 BatchJobService 可以减少发送的请求数量，但必须评估其使用情况，以确定其是否适合您的需求。使用批处理的主要原因是最大限度地减少因暂时性错误而失败的 API 请求和重试操作的数量。这并不保证性能会得到提升，从而提高吞吐量或缩短作业完成时间。尝试不同的批处理和非批处理组合，以确定最适合您情况的解决方案。

操作

BatchJobService 支持 MutateOperation 中列出的所有操作，但有几个重要的例外情况。

由于 Google Ads API 会在启用部分失败的情况下执行作业中的所有操作，因此，如果作业被取消或个别操作失败，成功的操作不会被回滚。

MutateOperation 中的以下操作必须是原子操作，因此不支持部分失败，也不在批处理作业中受支持。请避免将这些操作添加到作业中，在请求中将 partial_failure 设置为 false，并改用 GoogleAdsService 中的 mutate 方法。

BatchJobService 中不支持的操作

• CampaignConversionGoalOperation
• ConversionGoalCampaignConfigOperation
• CustomConversionGoalOperation
• CustomerConversionGoalOperation
• CustomerOperation