批次處理

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

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

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

作業套件

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

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

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

BatchJobService 中不支援的作業

• CampaignConversionGoalOperation
• ConversionGoalCampaignConfigOperation
• CustomConversionGoalOperation
• CustomerConversionGoalOperation
• CustomerOperation