批次處理

大多數服務都提供同步 API,您必須提出要求,然後等待回應,但 BatchJobService 可讓您對多項服務執行批次作業,不必同步等待作業完成。

與服務專屬的變動作業不同,BatchJobService 中的單一工作可對廣告活動、廣告群組、廣告、條件、標籤和動態饋給項目等混合集合執行作業。提交的工作會平行執行,且 BatchJobService 會自動重試因暫時性錯誤 (例如速率限制錯誤) 而失敗的作業。Google Ads API 仍會按照API 作業的計數說明,將每項作業計入每日作業上限

BatchJobService 也允許您在要求中使用暫時 ID,以便在單一工作中提交相依作業。

作業

BatchJobService 支援 MutateOperation 中列出的所有作業,但有幾個重要例外狀況。

由於 Google Ads API 會在啟用部分失敗的情況下,執行工作中的所有作業,因此如果取消工作或個別作業失敗,系統不會回溯成功執行的作業。

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

BatchJobService 中不支援的作業