用量限制

使用限制可以保護 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 次寫入查詢。例如，在一分鐘內發出的 100 個標準寫入要求和 21 項密集寫入要求 (未指定廣告主)，將計為 205 次寫入查詢 (100 + (21 * 5) = 205)，且會超過現有的一般要求配額，每分鐘 200 次寫入查詢的限制。

下列方法視為密集寫入：

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

超過配額上限

萬一要求因超過 API 要求限製而失敗，API 會傳回 HTTP 狀態碼和錯誤原因。此外，回應主體也會詳細說明導致錯誤的原因。

以下清單顯示因超出 API 要求限製而造成的要求失敗可能錯誤，以及建議採取的行動。

程式碼	RPC	訊息	建議做法
429	RESOURCE_EXHAUSTED	資源已用盡 (例如檢查配額)。	您可以從 Google API 控制台查看使用情況，並修改工作流程，藉此更順暢地平行處理不同廣告主提出的要求，或是大幅減慢傳送要求的速度。

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