批次處理

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

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

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

作業套件

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

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

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

BatchJobService 中不支援的作業