Um sistema de cotas foi implementado para as APIs Home para garantir a confiabilidade do serviço e ajudar os desenvolvedores a gerenciar o volume de tráfego de maneira eficaz. As cotas nas APIs Home estão no nível do projeto Google Cloud.
O limite de taxa para as APIs Home é de 30.000 QPM (consultas por minuto) por projeto. Esse limite abrange todas as consultas enviadas pelas APIs Home.
Cota excedida
Quando o limite de taxa das APIs Home é excedido, uma
resourceExhaused
HomeError é gerada. As solicitações subsequentes serão rejeitadas
imediatamente com a mensagem "Cota excedida".
Se a cota for excedida, os apps precisarão apresentar uma espera exponencial e notificar os usuários se as ações forem temporariamente restritas.
Monitoramento
Use o Google Cloud Console para monitorar o uso em tempo real e configurar alertas proativos para quando você se aproximar de uma cota das APIs Home.
Para conferir as métricas atuais, acesse a seção Métricas do serviço da API Home no projeto Google Cloud associado ao registro do app em Google Home Developer Console.
Configurar alertas
Recomendamos que os parceiros configurem alertas para quando um limite (como 80%) da cota alocada for atingido. O suporte a alertas no Google Cloud é muito abrangente e altamente configurável.
Ao criar um alerta para cota, use as seguintes métricas em Cota do consumidor > Cota no criador de políticas.
- Uso da cota de alocação: serviceruntime.googleapis.com/quota/allocation/usage
- Limite de cota: serviceruntime.googleapis.com/quota/limit
Os parceiros também precisam configurar canais de notificação (como e-mail) para receber alertas de cota.
Consulte os recursos a seguir para saber mais sobre alertas e notificações e como configurá-los no Google Cloud:
Solicitar aumento de cota
Se o app tiver tráfego legítimo que exija limites maiores do que o limite de taxa padrão, você poderá pedir um aumento.
Para conferir o uso e os limites, acesse a seção Cotas e limites do sistema do serviço da API Home no projeto Google Cloud associado ao registro do app em Developer Console.
Para solicitar um aumento, edite uma cota específica. Consulte Solicitar um ajuste de cota na documentação do Google Cloud para instruções.