批次處理

大部分的服務都提供同步 API，需要您在提出要求後等候回應，但 BatchJobService 可讓您對多項服務執行批次作業，不必同步等待作業完成。

有別於服務專屬的 Change 作業，BatchJobService 中的單一工作可針對一組混合的廣告活動、廣告群組、廣告、條件、標籤和動態饋給項目運作。提交的工作會同時執行，BatchJobService 會自動重試因暫時性錯誤 (例如頻率限制錯誤) 而失敗的作業。根據 API 作業計數指示，Google Ads API 仍會將每項作業計入每日作業限制。

此外，BatchJobService 可讓您在要求中使用臨時 ID，您可以為單一工作提交相依作業。

注意： 使用 BatchJobService 可減少傳送的要求數量，但您必須評估其用途是否適合您的需求。使用批次處理的主要原因，是盡量減少 API 要求數量，以及因暫時性錯誤而失敗的重試作業。這麼做不保證能改善效能，進而提高處理量或加快工作完成速度。您需要實驗不同的批次和非批次處理組合，來找出最適合您的解決方案。

作業套件

BatchJobService 支援 MutateOperation 中列出的所有作業，但仍有少數重要的例外情況。

由於 Google Ads API 會在啟用部分失敗的工作中執行所有作業，因此如果工作取消或個別作業失敗，則已不會復原成功的作業。

MutateOperation 中的下列作業必須是 atomic，因此不支援部分失敗，「不支援」批次工作。請避免在工作中加入這些變數，請在要求中將 partial_failure 設為 false，並改用 GoogleAdsService 中的 mutate 方法。

BatchJobService 中不支援的作業

• CampaignConversionGoalOperation
• ConversionGoalCampaignConfigOperation
• CustomConversionGoalOperation
• CustomerConversionGoalOperation
• CustomerOperation