配額

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

配額限制

以下預設配額限制適用於所有 Campaign Manager 360 API 資源和方法。

• 每項專案每日 50,000 項要求 - 可增加。
• 每個專案每秒 1 次查詢 (QPS)。
  • 在 Google API 控制台中，這個配額稱為「每位使用者每分鐘查詢次數」，預設值為 60。您可以視需要調高此上限，上限為 600 (10 QPS)。

報表製作工具會強制執行額外的配額限制，具體限制取決於帳戶。詳情請參閱這篇說明中心文章和下表。

注意： 每日配額會在太平洋時間午夜 12 點更新。

超出配額限制

如果要求因超出配額限制而失敗 (這種情況不太可能發生)，API 會傳回 HTTP 狀態碼和錯誤原因。此外，回應的內文會詳細說明導致錯誤的原因。如需錯誤回應範例，請參閱「錯誤訊息」指南。

下表列出因超出配額限制而導致要求失敗的可能錯誤，以及建議的因應措施。

程式碼	原因	訊息	建議做法
403	dailyLimitExceeded	超出每日上限	未修正問題前請勿重試。請透過 Google API 控制台檢查您的使用情形，並修改工作流程以減少要求次數。如果您認為自己的使用量合理，可以申請額外配額。
403	quotaExceeded	這個帳戶已超過每日 x 份報表的配額。	請勿在當天為這個帳戶執行其他報表。如需協助，請與客戶經理聯絡。
403	quotaExceeded	這個使用者設定檔已超過每日 x 份報表的配額。	請勿在當天為這個使用者設定檔執行其他報表。請切換至其他使用者個人資料，或向客戶經理尋求協助。
403	quotaExceeded	這個帳戶已超過 x 份有效排定報表的配額。	請先停用不需要的定期報表，再重試這項要求。
403	quotaExceeded	擁有這份報表的使用者已超過 x 份有效排定報表的配額。	請先請報表擁有者停用不需要的定期報表，再重試這項要求。
403	quotaExceeded	這個使用者設定檔已超過 x 份有效排定報表的配額。	請先停用不需要的定期報表，再重試這項要求。
403	quotaExceeded	無法完成操作，因為您超過了某個限額。請與帳戶管理員聯絡以取得協助。	如需協助，請與客戶經理聯絡。
403	userRateLimitExceeded	使用者頻率限制超出	您可以透過 Google API 控制台提高每位使用者的限制，或是使用指數回退來降低傳送要求的頻率。不建議使用這個 API 同時提出寫入要求，或採用超過 10 QPS 的頻率限制。

要求增加每日配額

如果您認為應用程式需要額外的每日配額，可以按照下方說明申請。

以下說明僅適用於發生 dailyLimitExceeded 錯誤的專案。如要瞭解其他配額錯誤的建議做法，請參閱上表。

1. 前往 Google API 控制台中的 Campaign Manager 360 API。
2. 請在「指標」頁面中查看使用統計資料，確保應用程式運作正常。請仔細留意已呼叫的方法，並在繼續之前解決任何非預期或過度使用情形。
3. 如果使用情形正常，請前往「配額」頁面，按一下「每日查詢次數」旁的編輯圖示，然後點選「申請更多配額」連結。

提交增加要求前，請務必詳閱資訊並按照配額要求表單中的操作說明進行。

注意： 請務必提供您經常查看的電子郵件地址，因為我們的服務專員可能會與您聯絡，以便收集其他資訊。