視 API 而定,您可以限制「每日要求數」、「每分鐘要求數」或「每位使用者的每分鐘要求數」,明確限制要求數量。
您可以設定上限來限制付費用量。舉例來說,如要避免因使用量超出免費用量額度上限而產生費用,您可以針對要求設定每日上限。
查看及修改要求數量上限
您可以針對向任何付費 API 發出的所有要求設定數量限制。大部分的 API 都設有預設限制,但您可以將該限制調高到 Google 指定的上限。在您為專案啟用帳單功能前,部分 API 設定的限制非常低。
如要查看或變更 API 的限制,請按照下列步驟操作:
- 在 Google Cloud 控制台中,前往「APIs & Services Dashboard」(API 和服務資訊主頁) 頁面。
- 在專案清單中選取所需專案,或是建立新的專案。
- 找到您有興趣瞭解的 API,然後按一下其名稱。
- 按一下 [配額]。如果分頁導覽中沒有「配額」分頁,表示您選取的 API 未定義配額。
- 如要找出要設上限的配額,請在「Filter」(篩選條件) 欄位中輸入適當的屬性和值。舉例來說,如要尋找「子網路」配額,請輸入「Quota:Subnetworks」。
- 勾選要設上限的配額旁的核取方塊,然後按一下 「編輯配額」。
- 填寫配額變更表單,包括要設定的新限制。
- 按一下 [提交要求]。
部分 API 可讓您提交表單來要求更高的上限。某些 API 只有在 專案已啟用帳單功能時,才允許您指定較高的配額。
付費方案配額部分與Google 地圖付費方案有關,但該方案已停止提供。除非您是目前的 Google 地圖付費方案客戶,否則請勿編輯這些章節。
限制每位使用者的要求數量
為避免個別使用者用盡 API 配額,部分 API 包含預設的每位使用者每分鐘限制。
如要查看 API 是否包含預設的每位使用者每分鐘限制,請按照「查看及修改要求數限制」一文中的操作說明,在 API 配額中尋找相關資訊。如果該 API 設有這類預設限制,您可以按照這些操作說明的步驟修改該值,限制每位使用者可用的配額。如果 API 的配額未包含這項預設限制,則不支援新增或修改。
系統會以不重複的字串識別個別使用者。如果您建立的伺服器端應用程式 (其中呼叫程式碼託管於您擁有的伺服器) 可代表使用者發出要求,您向要限制用量的 API 發出的要求必須包含 quotaUser
參數。這個參數定義於「系統參數」說明文件中。
如要識別使用者,請使用 quotaUser=userID
網址查詢參數。這個值只用於實行短期配額限制,因此不需要使用真實的使用者 ID。您可以選擇任意的不重複使用者 ID 字串,長度上限為 40 個字元。
quotaUser
參數只用於限制每位使用者每分鐘可發出的要求數量。如果您不傳送 quotaUser
參數,系統會將所有呼叫判定為由伺服器機器所發出,這樣就無法依使用者來限制呼叫。
如果 API 未包含每位使用者每分鐘的預設限制,系統會忽略 quotaUser
值。
查看及編輯專案中 API 的所有配額
您可以在Google Cloud 主控台的「IAM 與管理」部分,查看特定專案中所有付費 API 的配額限制,以及要求提高配額上限。如要查看配額,請前往「配額」頁面。
如要查看及編輯專案中所有付費 API 的配額,請按照下列步驟操作:
- 前往 Google Cloud 控制台的「配額」頁面。
- 在專案清單中選取所需專案,或是建立新的專案。系統會顯示所選專案的「配額」頁面,當中每一行明細項目會列出特定服務中的各類可用配額。
- 按一下 「篩選表格」,即可按特定屬性查詢配額。
- 找出要編輯的配額,然後勾選旁邊的方塊。 您必須先啟用專案的帳單功能,才能勾選部分核取方塊。
- 按一下 「編輯配額」。
- 在顯示的「配額變更」窗格中,展開服務檢視畫面,然後視需要編輯該服務的配額,接著按一下「完成」。
- 重複以上操作,編輯每一項所選服務的配額。
- 輸入框會預先填入目前的配額限制。
- 提交時,帶有「警示」圖示 ( ) 的服務表示輸入內容有誤。
- 如要新增更多配額,請按照上述步驟選取。
- 如要從「配額變更」窗格中移除服務,請將滑鼠游標懸停在未展開的服務檢視畫面,然後按一下「刪除」圖示 ( )。
- 配額編輯完畢後,按一下「下一步」。
- 如果配額編輯要求需要審查,系統會顯示「聯絡人詳細資料」表單。在表單中填寫聯絡資訊。
- 按一下「提交要求」。