批次處理

雖然大多數服務都提供同步 API，要求您發出要求，然後等待回應，但 BatchJobService 提供一種方法，可在多個服務上執行批次作業，而不需要同步等待作業完成。

與服務專屬的變異操作不同，BatchJobService 中的單一工作可針對廣告活動、廣告群組、廣告、條件、標籤和動態饋給項目的混合集合運作。提交的工作會並行執行，而 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