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

Para solicitar un aumento de 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 tu empresa
    • Cuota actual
    • Motivo por el que deseas aumentar tu cuota
Cuota Límite Se puede aumentar
RequestSync (modo síncrono) Se permite un máximo de 1 solicitud simultánea por agentUserId. No
RequestSync (modo asíncrono) Límite predeterminado de 6,000 solicitudes por 60 segundos por integración de Cloud-to-cloud.
Consulta Límite predeterminado de 6,000 solicitudes por 60 segundos por integración de Cloud-to-cloud.
Sincronizar Límite predeterminado de 6,000 solicitudes por 60 segundos por integración de Cloud-to-cloud.
Borrar Límite predeterminado de 6,000 solicitudes por 60 segundos por integración de Cloud-to-cloud.
ReportStateAndNotification Límite predeterminado de 6,000 solicitudes por 60 segundos por integración de Cloud-to-cloud.

Cómo depurar problemas de cuota

Si tu integración experimenta límites de frecuencia, sigue los lineamientos que se indican a continuación 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 de ReportStateAndNotification debido al límite de frecuencia, no se podrá sincronizar el estado del dispositivo físico, lo que dejará el 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 coincide 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 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.