Administración de la cuota

Se implementó un sistema de cuotas para las APIs de Home con el objetivo de 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 aplican a nivel del 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 búsquedas enviadas a través de las APIs de Home.

Se superó la cuota

Cuando se supera el límite de frecuencia de las APIs para la casa, se genera un resourceExhaused HomeException. Las solicitudes posteriores se rechazarán de inmediato con el mensaje "Se superó la cuota".

En caso de que se exceda la cuota, las apps deben incluir una retirada exponencial y notificar a los usuarios si las acciones se restringen de forma temporal.

Supervisión

Usa la consola de Google Cloud 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 cuando se supere un umbral (por ejemplo, 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 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 de Google Cloud para obtener instrucciones.