Como limitar o uso da API

Dependendo da API, é possível limitar explicitamente as solicitações definindo limites de solicitação por dia, por minuto ou 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.

Modificar os limites no 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 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 o item de menu Cotas não estiver presente no painel de navegação à esquerda, isso significa que a API selecionada não tem cotas definidas.
  5. Expanda o serviço com a cota que você quer alterar e clique no ícone de edição dessa cota.
  6. Insira o Limite de cota de sua preferência até o limite especificado pelo Google e clique em Salvar.

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.

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. Se esse limite padrão existir, modifique esse valor conforme descrito na seção anterior para limitar a cota disponível para cada usuário.

Usuários individuais são identificados por um string único. Se você estiver criando um aplicativo do lado do servidor (em que o código de chamada está hospedado em um servidor seu) para fazer solicitações em nome dos usuários, as suas solicitações precisam conter o parâmetro quotaUser.

Para identificar um usuário, use o parâmetro quotaUser=userID. Esse valor é apenas para a aplicação de cotas de curto prazo, de modo que não é necessário 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.

Ver e editar todas as cotas de APIs de um projeto

Para revisar, editar e solicitar limites de cota mais altos para todas as APIs faturáveis em um determinado projeto, acesse a página Cotas na seção IAM e administrador do Console do Cloud.

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

  1. No Console do 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. Use o campo Filtro para filtrar a lista de cotas por Serviço, Nome do limite, Status da cota, ID do serviço e/ou Métrica.
  4. Marque a caixa de seleção ao lado das cotas que você quer editar. O faturamento precisa estar ativado no projeto para que você clique nas caixas de seleção.
  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.

Testar

  1. Na página Visão geral do example-db, clique em Criar tabela no início da lista de tabelas.

    O Console do Cloud exibe a página Escrever instruções DDL.

  2. Insira:

    google_sql_name

    CREATE TABLE Singers (
      SingerId   INT64 NOT NULL,
      FirstName  STRING(1024),
      LastName   STRING(1024),
      SingerInfo BYTES(MAX),
      BirthDate  DATE,
    ) PRIMARY KEY(SingerId);
    

    postgresql_name

    CREATE TABLE Singers ( SingerId BIGINT PRIMARY KEY, FirstName VARCHAR(100), LastName VARCHAR(100), SingerInfo BYTEA, BirthDate TIMESTAMPTZ );

  3. Clique em Enviar.