Ce document répertorie les quotas et les limites qui s'appliquent à Cloud Natural Language.
Un quota limite la quantité d'une ressource Google Cloud partagée particulière que votre projet Google Cloud peut utiliser, y compris les composants matériels, logiciels et réseau. Par conséquent, les quotas font partie d'un système qui effectue les opérations suivantes :
- Surveille votre utilisation ou votre consommation des produits et services Google Cloud
- Limite la consommation de ces ressources, par exemple pour garantir l'équité et réduire les pics d'utilisation.
- Gère des configurations qui appliquent automatiquement des restrictions recommandées.
- Fournit un moyen de demander ou d'effectuer des modifications de quota.
Dans la plupart des cas, lorsqu'un quota est dépassé, le système bloque immédiatement l'accès à la ressource Google concernée et la tâche que vous essayez d'effectuer échoue. Dans la plupart des cas, les quotas s'appliquent à chaque projet Google Cloud. Ils sont partagés entre toutes les applications et adresses IP qui utilisent ce projet.
Pour demander une augmentation ou une diminution de la plupart des quotas, vous pouvez utiliser Google Cloud Console. Pour en savoir plus, consultez Demander une augmentation de quota.
Des limites s'appliquent également aux ressources Natural Language. Ces limites ne sont pas liées au système de quotas. Sauf indication contraire, les limites ne peuvent pas être modifiées.
Restrictions linguistiques
L'API Natural Language n'est pour le moment compatible qu'avec les langues répertoriées sur la page Langues acceptées.
Quotas de contenu
Le contenu destiné à l'API Natural Language est fourni sous forme de chaîne de texte. L'API Natural Language découpe ce texte en une série de jetons, qui correspondent grosso modo aux délimiteurs de mots. Les différentes fonctionnalités de l'API Natural Language (analyse des sentiments, extraction d'entités et analyse syntaxique) utilisent toutes ces jetons, qui forment la base de toute analyse de texte.
Les quotas de taille s'appliquent aux contenus suivants pour chaque requête :
| Quota de contenu | Valeur | Résultat en cas de dépassement |
|---|---|---|
| Contenu textuel | 1 000 000 octets | Erreur renvoyée par l'API |
| Quota de jetons | 100 000 jetons | Ignoré |
| Mentions d'entités | 5 000* | Ignoré |
Si vous essayez de traiter un volume de contenu excédant le quota de contenu textuel, vous générerez une erreur. Si vous essayez de traiter un volume de jetons excédant le quota de jetons, aucune erreur ne sera générée, mais les jetons au-delà du quota seront ignorés.
Notez qu'en fonction de l'encodage utilisé dans le contenu textuel, le nombre d'octets peut être différent du nombre de caractères.
* Le quota de mentions d'entités inclut non seulement les mentions renvoyées dans le document, mais aussi toutes les références nominales à ces entités, y compris celles sous forme de pronoms.
Notez que ces pronoms ne sont pas renvoyés directement dans le champ mentions, mais ils sont tout de même déduits du quota.
Quotas de requêtes
Voici les quotas d'utilisation actuels de l'API Cloud Natural Language (sous réserve de modification) :
| Type de quota | Quota d'utilisation |
|---|---|
| Requêtes par minute | 600 |
| Requêtes par jour | 800 000 |