Limitar a utilização da API

Consoante a API, pode limitar explicitamente os pedidos limitando os pedidos por dia, os pedidos por minuto ou os pedidos por minuto por utilizador.

Pode querer limitar a utilização faturável definindo limites máximos. Por exemplo, para evitar a faturação da utilização que exceda os limites de utilização de cortesia gratuitos, pode definir limites máximos de pedidos por dia.

Importante: os limites de quota nem sempre são totalmente precisos, uma vez que existe alguma latência entre o momento em que uma quota é ultrapassada e o momento em que a aplicação começa. Quando usar a quota como uma ferramenta para limitar a faturação, permita alguma margem.

Veja e modifique os limites do número de pedidos

Pode definir limites para todos os pedidos a qualquer API faturável. A maioria das APIs define limites predefinidos, mas pode alterar esse limite até um máximo especificado pela Google. Algumas APIs definem um limite baixo até ativar a faturação no seu projeto.

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

1. Na Google Cloud consola, aceda à página Painel de controlo de APIs e serviços.

   Aceda ao painel de controlo de APIs e serviços

2. Na lista de projetos, selecione um projeto ou crie um novo.
3. Clique no nome da API que lhe interessa.
4. Clique em Quotas. Se o separador Quotas não estiver presente na navegação por separadores, significa que a API que selecionou não tem quotas definidas.
5. Para encontrar a quota que quer limitar, introduza as propriedades e os valores adequados no campo Filtro. Por exemplo, para encontrar a quota Subnetworks, introduza Quota:Subnetworks.
6. Clique na caixa de verificação junto à quota que quer limitar e, de seguida, clique em EDITAR QUOTAS.
7. Preencha o formulário de alteração da quota, incluindo o novo limite que quer definir.
8. Clique em ENVIAR PEDIDO.

Algumas APIs permitem-lhe pedir um limite mais elevado através do envio de um formulário. Algumas APIs permitem especificar uma quota mais elevada apenas se a faturação estiver ativada no projeto.

Nota: só pode definir limites faturáveis diários em APIs faturáveis e, em alguns casos, apenas se a faturação estiver ativada no seu projeto. Se o seu projeto não usar APIs faturáveis, não pode definir limites diários. Saiba mais acerca das contas de faturação.

As secções de quota do plano Premium referem-se ao plano Google Maps Premium, que já não é oferecido. A menos que seja um cliente atual do Google Maps Premium Plan, não edite essas secções.

Limitar pedidos por utilizador

Para impedir que utilizadores individuais esgotem a sua quota da API, algumas APIs incluem um limite predefinido por utilizador por minuto.

Para verificar se a sua API inclui um limite predefinido por utilizador por minuto, procure-o nas quotas da API, conforme descrito nas instruções para ver e modificar os limites do número de pedidos. Se existir um limite predefinido para essa API, pode modificar esse valor para limitar a quota disponível para cada utilizador seguindo os passos destas instruções. Se a sua API não incluir este limite predefinido nas respetivas quotas, a adição ou a modificação do mesmo não é suportada.

Os utilizadores individuais são identificados por uma string única. Se estiver a criar uma aplicação do lado do servidor (em que o código de chamada está alojado num servidor que lhe pertence) que faz pedidos em nome dos utilizadores, os seus pedidos à API para a qual está a limitar a utilização têm de incluir o parâmetro quotaUser. Este parâmetro está definido na documentação Parâmetros do sistema.

Nota: embora os limites por utilizador sejam especificados em consultas por minuto, permitimos picos de utilização a curto prazo. Por conseguinte, deve definir os limites com base nos níveis de tráfego médios sustentados. Se alguém tentar usar uma API em excesso destas definições, os pedidos acionam um erro de limite excedido.

Para identificar um utilizador, use o parâmetro de consulta de URL quotaUser=userID. Este valor destina-se apenas à aplicação de quotas a curto prazo, pelo que não precisa de usar um ID do utilizador real. Pode escolher qualquer string arbitrária com menos de 40 carateres que identifique um utilizador de forma exclusiva.

O parâmetro quotaUser só é usado para limitar os pedidos por utilizador por minuto. Se não enviar o parâmetro quotaUser, todas as chamadas são atribuídas às suas máquinas de servidor. Neste caso, não é possível limitar as chamadas por utilizador.

Se a sua API não incluir um limite predefinido por utilizador por minuto, os valores de quotaUser são ignorados.

Importante: quando enviar um identificador do utilizador, certifique-se de que cumpre todas as leis locais, incluindo as leis relacionadas com a divulgação de informações pessoais que envia com cada pedido. A prática recomendada é incluir o mínimo de informações pessoais possível.

Ver e editar todas as quotas de APIs num projeto

Pode rever, editar e pedir limites de quota mais elevados para todas as APIs faturáveis num determinado projeto ao ver a página Quotas na secção IAM e administração daGoogle Cloud consola.

Para ver e editar as quotas de todas as APIs faturáveis no seu projeto, faça o seguinte:

1. Na Google Cloud consola, aceda à página Quotas.

   Aceder a Quotas

2. Na lista de projetos, selecione um projeto ou crie um novo. É apresentada a página Quotas do projeto selecionado, com um elemento publicitário para cada tipo de quota disponível em cada serviço.
3. Clique em Filtrar tabela para consultar a sua quota por uma propriedade específica.
4. Selecione a caixa junto às quotas que quer editar. A faturação tem de estar ativada no projeto para poder clicar em algumas das caixas de verificação.
   Se preferir editar todas as quotas de uma única API, clique no nome do serviço para aceder à página Quotas dessa API.
5. Clique em EDITAR QUOTAS.
6. No painel Alterações de quota apresentado, expanda a vista de serviço e, de seguida, edite as quotas nesse serviço conforme necessário e, em seguida, clique em CONCLUÍDO.
7. Repita o processo para editar as quotas em cada um dos serviços selecionados.
   • Os limites de quota atuais estão pré-preenchidos nas caixas de entrada.
   • Um serviço com um ícone de alerta () no envio tem erros de entrada.
   • Pode adicionar mais quotas para editar selecionando-as conforme descrito anteriormente.
   • Pode remover um serviço do painel Alterações de quota passando o cursor do rato sobre a vista de serviço não expandida e, de seguida, clicando no ícone de eliminar ().
8. Quando terminar de editar as quotas, clique em SEGUINTE.
9. Se o seu pedido de edição de quota precisar de revisão, é apresentado o formulário Detalhes de contacto. Preencha o formulário com os seus detalhes de contacto.
10. Clique em ENVIAR PEDIDO.