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 do 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 uma mensagem "Cota excedida".
Se a cota for excedida, os apps vão precisar usar uma espera exponencial e notificar os usuários se as ações forem temporariamente restritas.
Monitoramento
Use o console do Google Cloud 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 do Google Cloud associado ao registro do app no Google Home Developer Console.
Configurar alertas
Recomendamos que os parceiros configurem alertas para quando um limite (como 80%) da cota de alocação for ultrapassado. O suporte a alertas no Google Cloud é muito amplo 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 padrão, solicite 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 do Google Cloud associado ao registro do app no Developer Console.
Para solicitar um aumento, edite uma cota específica. Consulte Solicitar um ajuste de cota na documentação do Google Cloud para ver instruções.