Como limitar o uso da API

Dependendo da API, é possível limitar explicitamente as solicitações limitando o número de solicitações por dia, solicitações por minuto ou solicitações por minuto por usuário.

Defina limites para regular o uso faturável. Por exemplo, para evitar a cobrança pelo uso além dos limites de cortesia, defina limites de solicitações diárias.

Importante: os limites de cota nem sempre são totalmente precisos, porque há uma latência entre o momento em que uma cota é ultrapassada e o início da aplicação. Ao usar a cota como uma ferramenta para limitar o faturamento, permita algum buffer.

Ver e modificar os limites do número de solicitações

Você pode definir limites para todas as solicitações para qualquer API faturável. A maioria das APIs define limites padrão, mas é possível alterar esse limite até o máximo especificado pelo Google. Em algumas APIs, o limite definido é baixo até que você ative o faturamento no seu projeto.

Para visualizar ou alterar os limites da sua API, faça o seguinte:

1. No console do Google Cloud, acesse a página Painel de APIs e serviços.

   Acessar "Painel de APIs e serviços"

2. na lista de projetos, selecione um projeto ou crie um novo;
3. clique no nome da API em que está interessado.
4. clique em Cotas. Se a guia Cotas não estiver presente no painel de navegação, a API selecionada não tem cotas definidas.
5. Para encontrar a cota que você quer limitar, insira as propriedades e os valores apropriados no campo Filtro. Por exemplo, para encontrar a cota de Sub-redes, insira Cota:Sub-redes.
6. Clique na caixa de seleção ao lado da cota que você quer limitar e, em seguida, clique em EDITAR COTAS.
7. Preencha o formulário de alteração de cota, incluindo o novo limite que você quer definir.
8. Clique em ENVIAR SOLICITAÇÃO.

Algumas APIs permitem solicitar um limite maior enviando um formulário. Algumas APIs só permitem especificar uma cota maior se o faturamento estiver ativado no projeto.

Observação: é possível definir limites faturáveis diários apenas em APIs faturáveis e, em alguns casos, somente se o faturamento estiver ativado no seu projeto. Se o projeto não usa APIs faturáveis, não é possível definir limites diários. Saiba mais sobre contas de faturamento.

As seções de cota do Plano Premium pertencem ao Plano Premium do Google Maps, que não é mais oferecido. A menos que você seja um cliente do Plano Premium do Google Maps, não edite essas seções.

Como limitar solicitações por usuário

Para evitar que um único usuário use toda a cota de API, algumas APIs incluem um limite padrão por usuário e por minuto.

Para verificar se a API inclui um limite padrão por usuário e por minuto, procure-o nas cotas da API, conforme descrito nas instruções para Visualizar e modificar os limites do número de solicitações. Se houver um limite padrão para essa API, modifique esse valor para limitar a cota disponível para cada usuário seguindo as etapas nestas instruções. Se a API não incluir esse limite padrão nas cotas, não será possível adicionar ou modificar o limite.

Os usuários individuais são identificados por uma string única. Se você estiver criando um aplicativo do lado do servidor (em que o código de chamada está hospedado em um servidor pertencente) que faz solicitações em nome dos usuários, suas solicitações para a API em que você está limitando o uso precisam incluir o parâmetro quotaUser. Esse parâmetro é definido na documentação Parâmetros do sistema.

Observação: os limites por usuário são especificados em consultas por segundo, mas picos de uso de curto prazo são permitidos. Portanto, defina os limites com base nos níveis de tráfego médio sustentado. Se alguém tentar usar uma API além dessas configurações, um erro de limite excedido será acionado pela solicitação.

Para identificar um usuário, use o parâmetro de consulta de URL quotaUser=userID. Esse valor é usado apenas para restrições de cota de curto prazo, portanto, você não precisa usar um ID de usuário real. É possível escolher qualquer string arbitrária com menos de 40 caracteres que identifique um usuário de forma exclusiva.

O parâmetro quotaUser é usado apenas para limitar solicitações por usuário por minuto. Se você não enviar o parâmetro quotaUser, todas as chamadas serão atribuídas às suas máquinas servidor. Nesse caso, as chamadas não poderão ser limitadas pelo usuário.

Se a API não incluir um limite padrão por usuário a cada minuto, os valores de quotaUser vão ser ignorados.

Importante:ao enviar qualquer identificador de usuário, obedeça às leis locais, incluindo aquelas relacionadas à divulgação de informações pessoais enviadas em cada solicitação. A prática recomendada é incluir o mínimo de informações pessoais possível.

Ver e editar todas as cotas de APIs de um projeto

Revise, edite e solicite limites de cota mais altos para todas as APIs faturáveis de determinado projeto na página Cotas, na seção IAM e administrador do Console do Google Cloud.

Para visualizar e editar as cotas de todas as APIs faturáveis do projeto, siga estas etapas:

1. No console do Google Cloud, acesse a página Cotas.

   Acessar Cotas

2. na lista de projetos, selecione um projeto ou crie um novo; A página Cotas do projeto selecionado será exibida para listar um item de linha para cada tipo de cota disponível em cada serviço.
3. Clique em Filtrar tabela para consultar sua cota por uma propriedade específica.
4. Marque a caixa de seleção ao lado das cotas que você quer editar. O faturamento precisa estar ativado no projeto para que seja possível clicar em algumas das caixas de seleção.
   Se preferir editar todas as cotas de uma única API, clique no nome do serviço para acessar a página "Cotas" dessa API.
5. Clique em EDITAR COTAS.
6. No painel Alterações de cota exibido, expanda a visualização do serviço, edite as cotas desse serviço conforme necessário e clique em CONCLUÍDO.
7. Repita para editar as cotas de cada um dos serviços selecionados.
   • Os limites de cota atuais são pré-preenchidos nas caixas de entrada.
   • Um serviço com um ícone de alerta () no envio tem erros de entrada.
   • Para adicionar mais cotas para edição, selecione as cotas conforme descrito anteriormente.
   • Para remover um serviço do painel Alterações de cota, passe o cursor sobre a visualização do serviço não expandida e clique no ícone de exclusão ().
8. Quando terminar de editar as cotas, clique em PRÓXIMO.
9. Se a solicitação de edição de cota precisar de revisão, o formulário de Detalhes do contato é exibido. Preencha o formulário com os seus dados de contato.
10. Clique em ENVIAR SOLICITAÇÃO.