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 Google Cloud projeto.
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
HomeException
é gerada. As solicitações subsequentes serão rejeitadas imediatamente com uma mensagem de "Cota excedida".
Caso a cota seja excedida, os apps precisam apresentar uma espera exponencial e notificar os usuários se as ações forem restritas temporariamente.
Monitoramento
Use o console 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 Google Cloud associado ao registro do seu app em Google Home Developer Console.
Configurar alertas
Recomendamos que os parceiros configurem alertas para ultrapassar um limite (como 80%) da cota alocada. O suporte a alertas em Google Cloud é muito extenso e altamente configurável.
Ao criar um alerta para a 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 tráfego legítimo do seu app exigir limites maiores do que o limite de taxa padrão, você poderá solicitar 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 seu app em Developer Console.
Para solicitar um aumento, edite uma cota específica. Consulte Solicitar um ajuste de cota na documentação Google Cloud para instruções.