最佳做法和限制

使用 BatchJobService 時,請考慮下列規範。

提高處理量

  • 比起多個小型工作,建議使用較少的大型工作。

  • 按照作業類型排序已上傳的作業。舉例來說,如果您的工作包含新增廣告活動、廣告群組和廣告群組條件的作業,請排序上傳中的作業,先讓所有廣告活動作業先後,再依序顯示所有廣告群組作業和所有廣告群組條件作業

  • 在相同類型的作業中,提升效能以按父項資源分組的效能。舉例來說,如果您有許多 AdGroupCriterionOperation 物件,則依廣告群組將作業分組,會比同時影響不同廣告群組中廣告群組條件的交替作業更有效率。

避免並行問題

  • 為同一帳戶提交多項並行工作時,請嘗試減少在相同物件上同時執行作業的可能性,同時維持大型工作大小。許多嘗試變更同一組物件的未完成工作 (狀態為 RUNNING) 可能會導致類似死結的情況,進而導致嚴重減慢甚至工作失敗的情況。

  • 請勿在相同工作中提交多項變更相同物件的作業,否則結果可能難以預測。

以最佳方式擷取結果

  • 請勿太常輪詢工作狀態,否則可能會達到頻率限制錯誤的風險。

  • 每頁請勿擷取超過 1,000 筆結果。由於負載或其他因素,伺服器可能會傳回少於這個值。

  • 結果順序會與上傳訂單相同。

其他使用指南

  • 您可以設定批次工作在取消前可以執行的時間長度上限。建立新的批次工作時,請將 metadata.execution_limit_seconds 欄位設為您偏好的時間限制,以秒為單位。如果未設定 metadata.execution_limit_seconds,則沒有預設時間限制。

  • 建議每個 AddBatchJobOperationsRequest 新增的作業不得超過 1,000 個,並使用 sequence_token 將其餘作業上傳至同一個工作。視作業內容而定,一個 AddBatchJobOperationsRequest 中包含太多作業時,可能會導致「REQUEST_TOO_LARGE錯誤。您可以藉由減少作業數量,然後重試 AddBatchJobOperationsRequest 來處理這個錯誤。

限制

  • 每個 BatchJob 最多支援一百萬項作業。

  • 每個帳戶一次最多可同時擁有 100 個有效或待處理的工作。

  • 系統會自動移除超過 7 天的待處理工作。