配額

配額可以保護 Google 的基礎架構,避免以不當方式使用 Campaign Manager 360 API 的自動化程序。可確保其中一個開發人員的操作不會對大型社群造成負面影響。

配額限制

下列預設配額限制由所有 Campaign Manager 360 API 資源和方法共用。

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

「報表製作工具」會強制執行額外的帳戶配額限制。如要瞭解詳情,請參閱這篇說明中心文章和下表。

超過配額限制

在極少數情況下,如果要求超過配額限制,API 會傳回 HTTP 狀態碼,以及錯誤的原因。此外,回應的主體內含導致錯誤的原因說明。如需錯誤回應的範例,請參閱錯誤訊息指南。

下列清單列出了超過配額限制,導致要求失敗時,可能發生的錯誤和建議做法。

程式碼 原因 訊息 建議做法
403 超出每日上限 超出每日上限 未修正問題前請勿重試。透過 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. 請在「Metrics」頁面中查看用量統計資料,確保應用程式正常運作。請仔細呼叫呼叫的方法,並處理任何非預期或超額用量後再繼續。
  3. 如果用量正常,請前往「配額」頁面,按一下「每日查詢數」旁邊的編輯圖示,然後按一下「申請更多配額」連結。

提交審查要求之前,請務必詳閱相關資訊並依照配額要求表單中的指示操作。