配額

Display & Video 360 API 配額會限制專案向 API 發出要求的速率。

請按照下列最佳做法，更妥善地運用 Display & Video 360 API 配額。

同時向多個廣告主提出要求

Display & Video 360 API 配額是依專案和廣告主設定。專案配額會限制專案提出的要求。廣告主配額會限制專案向廣告主提出的要求。

如要用盡專案配額，請同時向多個廣告主提出要求。

使用 list 查詢參數

使用 list 方法查詢參數，只納入所需資源。資源越少，列出資源所需的請求就越少。

list 方法提供三項重要參數：

• pageSize 會設定要求可傳回的資源數量。預設頁面大小取決於方法。將這個值設為最高，即可在每個要求中列出更多資源。
• filter 會根據提供的條件限制列出的資源。將此值設為僅列出部分資源。詳情請參閱「篩選清單要求」。
• orderBy 依指定屬性排序列出的資源。設定此值，即可透過較少的要求擷取資源清單的上限或下限。

使用大量和資源層級函式

大量和資源範圍函式可執行複雜工作。對這些方法發出單一要求，即可取代對其他方法發出的多個要求。

如要進一步瞭解這些方法，請參閱「大量要求」。

快取 ID

許多 Display & Video 360 API 動作都需要使用 API 擷取的 ID。例如指定目標選項 ID 和 Google 目標對象 ID。在本機儲存 ID，不必持續擷取。

使用已淘汰或刪除的資源 ID 可能會傳回錯誤。建議每週擷取快取 ID，確認 ID 狀態。

使用指數輪詢

指數輪詢是一種錯誤處理策略，並會重試要求 (不斷增加每次重試的間隔時間)。

輪詢長時間執行的工作 (例如 SDF 下載工作) 時，指數輪詢策略可減少傳送的要求數量。

我們的 SDF 下載程式碼範例使用指數輪詢搭配用戶端程式庫。以下是指數輪詢流程的範例：

• 使用 get 要求擷取 Operation 物件。
  • 如果 done 不是 true，工作仍在執行中。
  • 等待 5 秒加上隨機秒數，然後重試要求。
• 擷取作業。
  • 如果 done 不是 true，工作仍在執行中。
  • 等待 10 秒加上隨機秒數，然後重試要求。
• 擷取作業。
  • 如果 done 不是 true，工作仍在執行中。
  • 等待 20 秒加上隨機秒數，然後重試要求。
• 擷取作業。
  • 如果 done 不是 true，工作仍在執行中。
  • 等待 40 秒加上隨機秒數，然後重試要求。
• 擷取作業。
  • 如果 done 不是 true，工作仍在執行中。
  • 等待 80 秒加上隨機秒數，然後重試要求。
• 繼續這個模式，直到 done 為 true 或達到最長經過時間。