Esta página foi traduzida pela API Cloud Translation.
Switch to English

Uso da API Capping

Dependendo da API, é possível limitar explicitamente as solicitações de diversas maneiras, incluindo solicitações por dia, solicitações por minuto e 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.

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 é bem baixo até que você ative o faturamento no seu projeto.

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

  1. consulte a página Painel em Serviços e APIs no Console do Cloud;
  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. Na linha da cota que você quer alterar, clique no ícone de edição () e insira a cota total da sua preferência, até o limite especificado pelo Google.

Para algumas APIs, é possível solicitar um limite maior por meio de um formulário. Em certas APIs, o acesso a cotas mais altas é permitido somente 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 atual do Google Maps Premium, não edite essas seções se estiver tentando limitar seu uso.

Como limitar solicitações por usuário

Para evitar que usuários individuais esgotem sua cota de API, algumas APIs incluem um limite padrão por usuário por minuto. Se houver um limite padrão, é possível modificar 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 uma string única. Se você estiver criando um aplicativo do servidor (em que o código de chamada está hospedado em um servidor que pertence a você) que faz solicitações em nome de usuários, suas solicitações devem incluir o parâmetro quotaUser, conforme descrito abaixo.

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. Você pode escolher qualquer string arbitrária com menos de quarenta 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 de determinado projeto, acesse a página Cotas que está em IAM e administrador.

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

  1. Acesse a página Cotas do Console do Cloud em IAM e Administrador.
  2. na lista de projetos, selecione um projeto ou crie um novo;
    A página "Cotas" do projeto selecionado é exibida e lista um item de linha para cada tipo de cota disponível em cada serviço.
  3. Use o filtro acima da lista para ajustá-la por Serviço, Nome do limite, Status da cota e ID do serviço{/. 1} e/ou Metric.
  4. Para editar várias cotas:

    • Clique nas linhas da lista e selecione as cotas no painel do lado direito ou
    • Clique no botão TODOS OS COTAS em uma linha específica e selecione cotas na lista da página de detalhes.

    Depois clique em EDITAR COTAS. O faturamento precisa estar ativado no projeto para que você possa clicar nas caixas de seleção.

  5. No painel Editar cotas, selecione o serviço aexpandir a visualização eeditar cotas nesse serviço e cliqueCONCLU DO para começar.

  6. Repita para editar as cotas de cada um dos serviços selecionados.

    • Os limites atuais da cota são pré-preenchidos nas caixas de entrada.
    • Um serviço com um ícone de alerta () no envio tem erros de entrada.
    • Para adicionar cotas para edição, selecione as cotas conforme descrito anteriormente.
    • É possível remover um serviço do painel Editar cotas, clicando no ícone de exclusão ().
  7. Quando terminar de editar as cotas, clique emENVIAR SOLICITA O ,PR XIMA para começar.

  8. Se sua solicitação de edição de cota precisar ser analisada, no painel Editar cotas, à direita, preencha o formulário com seu Nome, endereço de e-mail e Telefone{ /1}, depois clique em ENVIAR SOLICITAO.