配額可避免 Google 基礎架構在自動化流程中使用 Campaign Manager 360 API 的方式不當。確保單一開發人員的行為不會對更廣大的社群造成負面影響。
配額限制
以下預設配額限制適用於所有 Campaign Manager 360 API 資源和方法。
- 每項專案每日 50,000 項要求 - 可增加。
- 每個專案每秒 1 次查詢 (QPS)。
- 在 Google API 控制台中，這個配額稱為「每位使用者每分鐘查詢次數」，預設值為 60。您可以視需要調高此上限，上限為 600 (10 QPS)。
報表製作工具會強制執行額外的配額限制，具體限制取決於帳戶。詳情請參閱這篇說明中心文章和下表。
超出配額限制
如果要求因超出配額限制而失敗 (這種情況不太可能發生)，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 錯誤的專案。如要瞭解其他配額錯誤的建議做法，請參閱上表。
- 前往 Google API 控制台中的 Campaign Manager 360 API。
- 請在「指標」頁面中查看使用統計資料，確保應用程式運作正常。請仔細留意已呼叫的方法，並在繼續之前解決任何非預期或過度使用情形。
- 如果使用情形正常，請前往「配額」頁面，按一下「每日查詢次數」旁的編輯圖示，然後點選「申請更多配額」連結。
提交增加要求前，請務必詳閱資訊並按照配額要求表單中的操作說明進行。