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 por cada 60 segundos al conjunto de tus llamadas a la API de consulta, sincronización, borrado, Report State y sincronización de solicitudes asíncronas, por cada integración de Cloud-to-cloud.

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

  • Asunto del correo electrónico: Solicitud para aumentar la cuota de la API de ReportState
  • Contenido del correo electrónico:
    • ID del proyecto
    • Nombre de su empresa
    • Cuota actual
    • Motivo por el que quieres aumentar tu cuota
Cuota 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 integración de Cloud-to-cloud. Sí
Consulta Límite predeterminado de 6,000 solicitudes cada 60 segundos por integración de Cloud-to-cloud. Sí
Sincronizar Límite predeterminado de 6,000 solicitudes cada 60 segundos por integración de Cloud-to-cloud. Sí
Borrar Límite predeterminado de 6,000 solicitudes cada 60 segundos por integración de Cloud-to-cloud. Sí
ReportStateAndNotification Límite predeterminado de 6,000 solicitudes cada 60 segundos por integración de Cloud-to-cloud. Sí

Depura problemas de cuota

Si tu integración experimenta un límite 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 provoca discrepancias de estado. Por ejemplo, si se descarta una solicitud ReportStateAndNotification debido al límite de frecuencia, el estado del dispositivo físico no se sincronizará, lo que dejará a 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 esperado, solicita un aumento de la cuota. Si este aumento es inesperado, revisa tu integración para determinar si un cambio inesperado está provocando que se envíe más tráfico a la API de Home Graph.