Se implementó un sistema de cuotas para las APIs de Home para garantizar la confiabilidad del servicio y ayudar a los desarrolladores a administrar de manera eficaz el volumen de tráfico. Las cuotas de las APIs de Home se encuentran a nivel de proyecto Google Cloud.
El límite de frecuencia para las APIs de Home es de 30,000 QPM (consultas por minuto) por proyecto. Este límite abarca todas las consultas enviadas a través de las APIs de Home.
Se superó la cuota
Cuando se supera el límite de frecuencia de las APIs de Home, se arroja un
resourceExhaused
HomeError. Las solicitudes posteriores se rechazarán de inmediato con el mensaje "Se superó la cuota".
En caso de que se supere la cuota, las apps deben incluir un retroceso exponencial y notificar a los usuarios si las acciones están restringidas de forma temporal.
Supervisión
Usa Google Cloud Console para supervisar el uso en tiempo real y configurar alertas proactivas para cuando te acerques a una cuota de las APIs de Home.
Para ver las métricas actuales, ve a la sección Métricas del servicio de la API de Home en el proyecto Google Cloud asociado con el registro de tu app en Google Home Developer Console.
Configura alertas
Recomendamos que los socios configuren alertas para superar un umbral (como el 80%) de la cuota asignada. La compatibilidad con alertas en Google Cloud es muy extensa y altamente configurable.
Cuando crees una alerta para la cuota, te recomendamos que uses las siguientes métricas en Cuota del consumidor > Cuota en el compilador de políticas.
- Uso de la cuota de asignación: serviceruntime.googleapis.com/quota/allocation/usage
- Límite de cuota: serviceruntime.googleapis.com/quota/limit
Los socios también deben configurar canales de notificaciones (como el correo electrónico) para recibir alertas de cuota.
Consulta los siguientes recursos para obtener más información sobre las alertas y las notificaciones, y cómo configurarlas en Google Cloud:
Solicita un aumento de la cuota
Si tu app tiene tráfico legítimo que requiere límites más altos que el límite de frecuencia predeterminado, puedes solicitar un aumento.
Para ver el uso y los límites, ve a la sección Cuotas y límites del sistema del servicio de la API de Home en el proyecto Google Cloud asociado con el registro de tu app en Developer Console.
Para solicitar un aumento, edita una cuota específica. Consulta Solicita un ajuste de cuota en la documentación Google Cloud para obtener instrucciones.