使用限制

使用限制可避免 Google 基礎架構在自動化流程中使用 Display & Video 360 API 的方式不當。確保單一開發人員的行為不會對更廣大的社群造成負面影響。

API 要求配額限制

Display & Video 360 API 使用兩種限制：

• 總配額限制：所有相關要求都會計入。
• 寫入配額限制：所有針對寫入方法提出的相關要求都會計入。寫入方法是指用於修改資源的方法，例如 create、patch、delete 或 bulkEdit。請注意，某些方法會比其他方法消耗更多寫入配額。

如果專案超出上述任一限制，可能會發生調節現象。

專案層級配額限制

下列預設配額限制適用於所有 Display & Video 360 API 資源和方法：

• 每項專案每分鐘的總要求數： 1500
• 每項專案每分鐘的寫入要求數： 700

廣告主專屬的請求配額限制

在要求網址中指定廣告主 ID 的方法，會計入額外的「每個專案的廣告主」配額限制。

所有網址路徑中指定廣告主 ID 的要求 (例如 advertisers.lineItems、advertisers.creatives 或 advertisers.channels 服務) 都會計入以下配額限制：

• 每個廣告主在每個專案中每分鐘的總請求數： 300
• 每個廣告主每項專案每分鐘的寫入要求數： 150

寫入密集方法

下列 API 方法會大量寫入，也就是說，這些方法會使用大量產品資源，因此會比其他寫入要求消耗更多寫入要求配額。

計算寫入要求配額用量時，系統會將針對寫入密集方法提出的要求計為 5 次寫入查詢。舉例來說，如果在 1 分鐘內提出 100 個標準寫入要求和 21 個寫入密集要求 (均未指定廣告客戶)，系統會將其計為 205 個寫入查詢 (100 + (21 * 5) = 205)，並超過現有的一般要求配額限制 (每分鐘 200 個寫入查詢)。

下列方法會大量寫入資料：

• customBiddingAlgorithms.scripts.create
• customBiddingAlgorithms.uploadScript
• firstPartyAndPartnerAudiences.create
• firstPartyAndPartnerAudiences.editCustomerMatchMembers
• media.upload

超出配額限制

如果您的要求因超出 API 要求限制而失敗，API 會傳回 HTTP 狀態碼和錯誤原因。此外，回應主體會詳細說明導致錯誤的原因。

下表列出因超出 API 要求限制而導致要求失敗的可能錯誤和建議動作。

程式碼	單次點擊收益	訊息	建議做法
429	RESOURCE_EXHAUSTED	資源已用盡 (例如檢查配額)。	請透過 Google API 控制台檢查您的用量，並修改工作流程，以便更有效地並行處理不同廣告客戶提出的要求，或更普遍地降低傳送要求的頻率。

您無法要求提高 Display & Video 360 API 配額限制。