配額

配額可避免 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 錯誤的專案。如要瞭解其他配額錯誤的建議做法，請參閱上表。

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

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