Questo documento elenca le quote e i limiti di sistema che si applicano a Cloud Natural Language.
- Le quote specificano la quantità di una risorsa condivisa e conteggiabile che puoi utilizzare. Le quote sono definite dai servizi Google Cloud, come Cloud Natural Language.
- I limiti di sistema sono valori fissi che non possono essere modificati.
Google Cloud utilizza le quote per contribuire a garantire l'equità e ridurre gli picchi di utilizzo e disponibilità delle risorse. Una quota limita la quantità di una risorsa Google Cloud che può essere utilizzata nel progetto Google Cloud. Le quote si applicano a una serie di tipi di risorse, inclusi hardware, software e componenti di rete. Ad esempio, le quote possono limitare il numero di chiamate API a un servizio, il numero di bilanciatori del carico utilizzati contemporaneamente dal tuo progetto o il numero di progetti che puoi creare. Le quote proteggono la community degli utenti di Google Cloud impedendo il sovraccarico dei servizi. Le quote ti aiutano anche a gestire le tue risorse Google Cloud.
Il sistema delle quote di Cloud esegue le seguenti operazioni:
- Monitora il tuo consumo di prodotti e servizi Google Cloud
- Limita il consumo di queste risorse
- Fornisce un modo per richiedere modifiche al valore della quota
Nella maggior parte dei casi, quando provi a utilizzare una risorsa per un volume maggiore di quello consentito dalla quota, il sistema blocca l'accesso alla risorsa e l'attività che stai tentando di eseguire non va a buon fine.
In genere, le quote si applicano a livello di progetto Google Cloud. L'utilizzo di una risorsa in un progetto non influisce sulla quota disponibile in un altro progetto. All'interno di un progetto Google Cloud, le quote sono condivise tra tutte le applicazioni e gli indirizzi IP.
Per modificare la maggior parte delle quote, utilizza la console Google Cloud. Per ulteriori informazioni, consulta Richiedere un aggiustamento della quota.
Esistono anche limiti di sistema per le risorse di linguaggio naturale. I limiti di sistema non possono essere modificati.
Restrizioni relative alle lingue
L'API Natural Language al momento include soltanto questa lista di lingue supportate.
Quote per i contenuti
Il contenuto viene fornito all'API Natural Language sotto forma di stringa di testo. L'API Natural Language elabora questo testo in una serie di token, che corrispondono approssimativamente ai limiti delle parole. Tutte le funzionalità dell'API Natural Language (analisi del sentiment, estrazione dell'entità e analisi sintattica) utilizzano questi token come elementi di base per eseguire le analisi sul testo fornito.
L'API contiene le seguenti quote relative alle dimensioni dei contenuti per ogni richiesta:
| Quota per i contenuti | Valore | Risultato dell'overflow |
|---|---|---|
| Contenuti testuali | 1.000.000 byte | Errore API |
| Quota dei token | 100.000 token | Ignorato |
| Menzioni di entità | 5000* | Ignorato |
Il tentativo di elaborare i contenuti che superano la quota dei contenuti testuali produce un errore. Il tentativo di elaborare i token che superano la quota dei token non produce un errore, ma qualsiasi token oltre tale quota verrà ignorato.
Occorre tenere presente che il numero di byte potrebbe non coincidere con il numero di caratteri, a seconda della codifica utilizzata nei contenuti di testo.
*La quota relativa alle menzioni di entità comprende non soltanto le menzioni restituite all'interno del documento, ma anche qualunque riferimento ai nomi delle suddette entità, inclusi i pronomi.
I pronomi non vengono restituiti direttamente nel campo mentions,
anche se incidono sul conteggio della quota.
Quote per le richieste
Di seguito sono riportate le quote di utilizzo attuali (soggette a modifiche) per l'API Cloud Natural Language:
| Tipo di quota | Quota di utilizzo |
|---|---|
| Richieste al minuto | 600 |
| Richieste al giorno | 800.000 |