批处理

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

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

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

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

操作

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

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

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

BatchJobService 中不支持的操作

• CampaignConversionGoalOperation
• ConversionGoalCampaignConfigOperation
• CustomConversionGoalOperation
• CustomerConversionGoalOperation
• CustomerOperation