配額與限制

這份文件列出 Cloud Natural Language 適用的配額和系統限制。

  • 「配額」有預設值,但通常可以申請調整。
  • 「系統限制」是固定值,無法變更。

Google Cloud 使用配額來確保公平性,並減少資源使用量和可用性出現劇烈波動的情況。配額會限制 Google Cloud 專案可使用的Google Cloud 資源數量,且適用多種資源類型,包括軟硬體和網路元件。舉例來說,配額可能會限制能向特定服務發出的 API 呼叫次數、專案可同時使用的負載平衡器數量,或是可建立的專案數量。配額機制可防止服務過載,保障Google Cloud 使用者社群的權益,同時也有助於您管理自己的 Google Cloud 資源。

Cloud Quotas 系統具備以下功能:

如果嘗試使用的資源量超過配額限制,系統通常會阻擋該資源的存取活動,您所執行的工作就會失敗。

配額的計算通常是以 Google Cloud 專案為基準。在某個專案中使用資源,不會影響另一個專案的可用配額。在同一個 Google Cloud 專案內,所有應用程式和 IP 位址會共用配額。

詳情請參閱「Cloud Quotas 總覽」。

如要調整大部分配額,請使用 Google Cloud 控制台。詳情請參閱「要求調整配額」。

自然語言資源也設有系統限制, 而且無法變更。

語言限制

Natural Language API 目前只支援語言支援頁面中所列的語言。

內容配額

Natural Language API 的內容是以文字字串的形式提供。Natural Language API 會對這些文字進行處理,產生一系列可約略對應至字詞邊界的「符記」。所有的 Natural Language API 功能 (情緒分析、實體擷取和語法分析) 都是根據這些符記對指定文字執行分析作業。

API 針對每個要求的這類內容大小設有以下配額限制:

內容配額 溢位結果
文字內容 100 萬個位元組 API 錯誤
符記配額 10 萬個符記 忽略超出限制的部分
實體提及次數 5,000 次* 忽略超出限制的部分

如果嘗試處理的內容超出文字內容配額限制,就會產生錯誤。如果嘗試處理的符記數量超出符記配額限制,則不會產生錯誤,但系統會忽略任何超出配額限制的符記。

請注意,位元組數量不一定等於字元數,實際的計算方式取決於文字內容所採用的編碼格式。

* 實體提及次數配額不只包含系統傳回的文件內提及次數;如果有任何名詞 (包括代名詞) 與指定實體相關,則這些名詞的出現次數也會包含在內。請注意,雖然代名詞確實會計入配額,但系統不會直接在 mentions 欄位中傳回代名詞。

頻率配額

Cloud Natural Language API 目前的 API 用量配額如下 (日後可能會有所調整):

配額類型 用量配額
每分鐘要求數 600
每日要求數 800,000