限制 API 使用量

視 API 而定，您可以限制「每日要求數」、「每分鐘要求數」或「每位使用者的每分鐘要求數」，明確限制要求數量。

這些是 API 專屬的用量限制。舉例來說，如要避免因超出免費用量而產生費用，您可以設定每日的要求數量上限。

這些限制旨在精細控管特定服務用量，並非用來做為專案整體的支出上限。如要避免整個專案或帳單帳戶產生預期外的費用，請參閱「建立、編輯或刪除預算和預算快訊」。

查看及修改要求數量上限

您可以針對向任何付費 API 發出的所有要求設定數量限制。大部分的 API 都設有預設限制，但您可以將該限制調高到 Google 指定的上限。在您為專案啟用帳單功能前，部分 API 設定的限制非常低。

如要查看或變更 API 的限制，請按照下列步驟操作：

  1. 在 Google Cloud 控制台中，前往「APIs & Services Dashboard」(API 和服務資訊主頁) 頁面。

    前往「API 和服務」資訊主頁

  2. 在專案清單中選取所需專案，或是建立新的專案。
  3. 找到您有興趣瞭解的 API，然後按一下其名稱。
  4. 按一下 [配額]。如果分頁導覽中沒有「配額」分頁，表示您選取的 API 未定義配額。
  5. 如要找出要設上限的配額，請在「篩選器」欄位中輸入適當的屬性和值。舉例來說，如要找出「子網路」配額，請輸入「配額：子網路」。
  6. 勾選要設限的配額旁的核取方塊，然後按一下 「編輯配額」。
  7. 填寫配額變更表單，包括要設定的新限制。
  8. 按一下 [提交要求]。

部分 API 可讓您提交表單來要求更高的上限。某些 API 只有在 專案已啟用帳單功能時，才允許您指定較高的配額。

付費方案配額部分與Google 地圖付費方案有關，該方案已停止提供。除非您是目前的 Google 地圖付費方案客戶，否則請勿編輯這些部分。

限制每位使用者的要求數量

為避免個別使用者用盡 API 配額，部分 API 包含預設的每位使用者每分鐘限制。

如要查看 API 是否包含預設的每位使用者每分鐘限制，請按照「查看及修改要求數限制」一文中的說明，在 API 配額中尋找相關資訊。如果該 API 有這類預設限制，您可以按照這些操作說明的步驟修改該值，限制每位使用者可用的配額。如果 API 的配額未包含這項預設限制，則不支援新增或修改。

根據預設，系統會使用經過驗證的主體來識別個別使用者。經過驗證的主體包括使用 OAuth 權杖的使用者帳戶、服務帳戶或聯盟工作負載身分。如果沒有經過驗證的主體，系統會使用用戶端 IP 位址。由於這項備援行為預設為啟用，即使您未指定使用者 ID，系統仍會強制執行每位使用者的配額。

使用用戶端 IP 位址備援有兩項主要限制：

  • 共用公開 IP：網路位址轉譯 (NAT) 閘道或 Proxy 後方的多位使用者 (例如學校辦公室或 VPN 端點)，會共用單一公開 IP 位址。他們的要求會匯集到同一個配額 bucket，可能導致配額過早用盡。
  • 以 IP 為基礎的規避行為：如果使用者可以存取大量 IPv6 位址或 VPN Proxy，就能輪流使用用戶端 IP 位址來規避速率限制，因此 IP 備援機制無法提供可靠的濫用行為防護。

如果您是從伺服器端應用程式呼叫 API，且呼叫程式碼是代管在您擁有的伺服器上，代表多位使用者，並使用單一已驗證的主體，則所有呼叫都會歸因於該單一主體。在這種情況下，無法個別為使用者設定通話上限。如要避免這種情況，您可以在要求中指定 quotaUser 參數或 X-Goog-Quota-User 標頭，覆寫預設的使用者識別碼和分區配額用量。這些參數定義在「系統參數」說明文件中。

如要使用 quotaUser 參數或 X-Goog-Quota-User 標頭覆寫預設使用者 ID，您必須使用設有服務限制 (例如 IP 位址限制或 HTTP 參照網址限制) 的有效 API 金鑰，識別配額專案。否則，系統會忽略參數或標頭，並改用預設使用者 ID。

如要識別使用者，請使用 quotaUser=userID 網址查詢參數。這個值只用於實行短期配額限制，因此不需要使用真實的使用者 ID。您可以選擇任意的不重複使用者 ID 字串，長度上限為 40 個字元。

為保護使用者隱私權及限制指標量， Google Cloud 主控台quotaUser和 Cloud Monitoring 不會儲存或顯示個別使用者或 IP 位址剖析的遙測資料。您可以查看專案配額總限制和總用量，但無法監控、覆寫或設定特定個別使用者的快訊。

如果 API 未包含每位使用者每分鐘的預設限制，系統會忽略 quotaUser 值。

查看及編輯專案中 API 的所有配額

您可以在Google Cloud 控制台的「IAM 與管理」部分中，查看及編輯特定專案中所有付費 API 的配額限制，以及要求提高配額上限。

如要查看及編輯專案中所有付費 API 的配額，請按照下列步驟操作：

  1. 前往 Google Cloud 控制台的「配額」頁面。

    前往配額頁面

  2. 在專案清單中選取所需專案，或是建立新的專案。系統會隨即顯示所選專案的「配額」頁面，當中每一行明細項目會列出特定服務中的各類可用配額。
  3. 按一下 「篩選表格」，即可按特定屬性查詢配額。
  4. 找出要編輯的配額，然後勾選旁邊的方塊。 您必須先啟用專案的帳單功能，才能勾選部分核取方塊。
  5. 按一下 「編輯配額」。
  6. 在顯示的「配額變更」窗格中，展開服務檢視畫面，然後視需要編輯該服務的配額，接著按一下「完成」。
  7. 重複以上操作，編輯每一項所選服務的配額。
    • 輸入框中會預先填入目前的配額限制。
    • 提交時帶有「警示」圖示 () 的服務表示有輸入錯誤。
    • 如先前所述，選取配額即可新增更多要編輯的配額。
    • 如要從「配額變更」窗格中移除服務，請將滑鼠游標懸停在未展開的服務檢視畫面，然後按一下「刪除」圖示 ()。
  8. 配額編輯完畢後，按一下「下一步」。
  9. 如果配額編輯要求需要審查，系統會顯示「聯絡人詳細資料」表單。請填寫表單，提供聯絡人詳細資料。
  10. 按一下「提交要求」。