本文列出 Cloud Natural Language 適用的配額和系統限制。
- 配額會指定您可使用的可計數共用資源數量。配額是由 Google Cloud 服務 (例如 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 |