Este documento lista as cotas e os limites do sistema que se aplicam ao Cloud Natural Language. As cotas especificam a quantidade de um recurso compartilhado e contável que você podem usar e são definidos pelos serviços do Google Cloud, como Cloud Natural Language. Os limites do sistema são valores fixos que não podem ser alterados.
O Google Cloud usa cotas para garantir a imparcialidade e reduzir picos no uso e na disponibilidade de recursos. Uma cota restringe quanto de um recurso do Google Cloud o projeto do Google Cloud pode usar. As cotas se aplicam a vários tipos de recursos, incluindo hardware, software e componentes de rede. Por exemplo, as cotas podem restringir o número de chamadas de API para um serviço, o número de balanceadores de carga usados simultaneamente pelo projeto ou o número de projetos que podem ser criados. As cotas protegem a comunidade de usuários do Google Cloud, impedindo a sobrecarga de serviços. As cotas também ajudam você a gerenciar seus próprios recursos do Google Cloud.
O sistema de cotas do Cloud faz o seguinte:
- Monitora o consumo de produtos e serviços do Google Cloud.
- Restringe o consumo desses recursos.
- Fornece um meio de solicitar mudanças no valor da cota
Na maioria dos casos, quando você tenta consumir mais de um recurso do que a cota permite, o sistema bloqueia o acesso ao recurso e a tarefa que você está tentando executar falha.
As cotas geralmente se aplicam ao projeto do nível Google Cloud. O uso de um recurso em um projeto não afeta a cota disponível em outro. Em um projeto do Google Cloud, as cotas são compartilhadas entre todos os aplicativos e endereços IP.
Para ajustar a maioria das cotas, use o console do Google Cloud. Para mais informações, consulte Solicitar um ajuste de cota.
Também há limites do sistema para os recursos do Natural Language. Não é possível alterar os limites do sistema.
Restrições de idioma
A API Natural Language é compatível atualmente apenas com os idiomas listados em Compatibilidade de idiomas.
Cotas de conteúdo
O conteúdo é fornecido para a API Natural Language no formato de uma string de texto. A API processa esse texto em uma série de tokens que, em termos gerais, correspondem aos limites de palavras. Esses tokens são usados como material de análise de texto em todos os recursos dessa API, como análise de sentimentos, extração de entidades e análise sintática.
A API contém as seguintes cotas quanto ao tamanho desse conteúdo em cada solicitação:
| Cota de conteúdo | Valor | Resultado da cota excedida |
|---|---|---|
| Conteúdo de texto | 1.000.000 de bytes | Erro na API |
| Cota de tokens | 100.000 tokens | Ignorado |
| Menções a entidades | 5.000* | Ignorado |
A tentativa de processar além da cota de conteúdo de texto causa um erro. No caso dos tokens, quando a cota é excedida, não há nenhum erro. Entretanto, qualquer token que ultrapasse essa cota é ignorado.
Observe que a contagem de bytes pode não refletir a contagem de caracteres dependendo da codificação usada no conteúdo de texto.
* A cota "Menção a entidades" não inclui apenas as menções retornadas dentro do documento, mas qualquer referência nominal a essas entidades, incluindo pronomes.
Observe que esses pronomes não são retornados diretamente no campo mentions, mas são contabilizado na cota.
Solicitar cotas
Atualmente, as cotas de uso da API Cloud Natural Language são estas e estão sujeitas a alterações:
| Tipo de cota | Cota de uso |
|---|---|
| Solicitações por minuto | 600 |
| Solicitações por dia | 800.000 |