Ce document répertorie les quotas et les limites système qui s'appliquent à Cloud Natural Language. Les quotas, qui indiquent la quantité de ressources partagées dénombrables auxquelles peuvent utiliser. Ils sont définis par les services Google Cloud tels que Cloud Natural Language. Les limites système sont des valeurs fixes qui ne peuvent pas être modifiées.
Google Cloud utilise des quotas pour garantir l'équité et réduire les pics d'utilisation et de disponibilité des ressources. Un quota limite la quantité de ressources Google Cloud que votre projet Google Cloud peut utiliser. Les quotas s'appliquent à différents types de ressources, y compris les composants matériels, logiciels et réseau. Par exemple, les quotas peuvent limiter le nombre d'appels d'API à un service, le nombre d'équilibreurs de charge utilisés simultanément par votre projet ou le nombre de projets que vous pouvez créer. Les quotas protègent la communauté des utilisateurs de Google Cloud en empêchant la surcharge des services. Les quotas vous aident également à gérer vos propres ressources Google Cloud.
Le système Cloud Quotas effectue les opérations suivantes :
- Surveille votre consommation de produits et services Google Cloud
- Limite votre consommation de ces ressources
- Permet de demander des modifications de la valeur de quota
Dans la plupart des cas, lorsque vous tentez d'utiliser plus d'une ressource que son quota ne le permet, le système bloque l'accès à la ressource et la tâche que vous essayez d'effectuer échoue.
Les quotas s'appliquent généralement au niveau du projet Google Cloud. Votre utilisation d'une ressource dans un projet n'affecte pas votre quota disponible dans un autre projet. Dans un projet Google Cloud, les quotas sont partagés entre toutes les applications et adresses IP.
Pour ajuster la plupart des quotas, utilisez la console Google Cloud. Pour en savoir plus, consultez Demandez un ajustement de quota.
Des limites du système s'appliquent également aux ressources Natural Language. Les limites système 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 |