批次處理

雖然大多數服務都提供同步 API,但您需要提出要求並等待回應,但 BatchJobService 可讓您在多個服務上執行批次作業,不必同步等候作業完成。

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

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

作業套件

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

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

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

BatchJobService 中不支援的作業