Cuotas y límites de casa inteligente

Google Home limita el uso y la asignación de recursos y aplica las cuotas correspondientes a cada proyecto. Las políticas específicas varían según la disponibilidad de los recursos, el perfil del usuario, el historial de uso del servicio y otros factores, y están sujetas a cambios sin previo aviso.

Límites de la API de HomeGraph

En esta sección, se enumeran los límites de frecuencia de la API de Google Home Graph. Estos límites se aplican a las APIs de REST y RPC.

Google aplica el límite predeterminado de 6,000 solicitudes cada 60 segundos al agregado de tus llamadas a la API de consulta, sincronización, eliminación, Report State, y sincronización de solicitudes asíncronas, por Cloud-to-cloud integración.

Para solicitar un aumento de cuota, comunícate con ha-certification@google.com y proporciona la siguiente información:

  • Asunto del correo electrónico: Request to increase ReportState API Quota
  • Contenido del correo electrónico:
    • ID del proyecto
    • Nombre de tu empresa
    • Cuota actual
    • Motivo por el que quieres aumentar tu cuota
Quota Límite Se puede aumentar
RequestSync (modo síncrono) Máximo de 1 solicitud simultánea por agentUserId. No
RequestSync (modo asíncrono) Límite predeterminado de 6,000 solicitudes cada 60 segundos por Cloud-to-cloud integración.
Consulta Límite predeterminado de 6,000 solicitudes cada 60 segundos por Cloud-to-cloud integración.
Sincronizar Límite predeterminado de 6,000 solicitudes cada 60 segundos por Cloud-to-cloud integración.
Borrar Límite predeterminado de 6,000 solicitudes cada 60 segundos por Cloud-to-cloud integración.
ReportStateAndNotification Límite predeterminado de 6,000 solicitudes cada 60 segundos por Cloud-to-cloud integración.

Depura problemas de cuota

Si tu integración experimenta una limitación de frecuencia, usa los siguientes lineamientos para diagnosticar y resolver problemas de cuota:

  1. Google limitará la frecuencia de las llamadas a la API que superen tu cuota. Esto afecta negativamente tu integración, ya que causa desajustes de estado. Por ejemplo, si se descarta una ReportStateAndNotification solicitud debido a la limitación de frecuencia, no se sincronizará el estado del dispositivo físico, lo que dejará la Google Home app (GHA) con información desactualizada.

  2. Si RequestSync es la API principal que experimenta errores, verifica que tu servicio no intente realizar más de una llamada simultánea por agentUserId.

  3. Revisa el crecimiento de tu tráfico a lo largo del tiempo. Si este crecimiento es coherente con un aumento en la cantidad de dispositivos, el lanzamiento de un nuevo tipo de dispositivo o algún otro lanzamiento previsto, solicita un aumento de cuota. Si este aumento es inesperado, revisa tu integración para determinar si un cambio inesperado está causando que se envíe más tráfico a la API de Home Graph.