多數服務都提供同步 API,並要求您提出要求後再等待回應,BatchJobService
可讓您針對多種服務執行批次作業,而不需同步等待作業完成。
與服務專屬的變化形式作業不同,BatchJobService
中的單一工作可以在一組混合的廣告活動、廣告群組、廣告、條件、標籤和資訊提供項目中運作。已提交的工作會同時執行,BatchJobService
會自動重試因頻率錯誤等暫時性錯誤而失敗的作業。根據 API 作業的計數指示,Google Ads API 仍會將每項作業計入您的每日作業限制中。
此外,BatchJobService
可讓您在要求中使用暫時 ID,以便在單一工作中提交相依作業。
作業套件
BatchJobService
支援 MutateOperation
中列出的所有作業,但有一些重要例外。
Google Ads API 會在啟用部分失敗的工作中執行所有作業。但是,以下 MutateOperation
作業不支援部分失敗,因為這些作業必須採用「原子化」。因此,批次工作「不」支援這些工作,您應該避免將其加入工作中。
如果您需要執行上述任何作業,請改用 GoogleAdsService
的 mutate
方法,並在要求中將 partial_failure
設定為 false
。