Quotas et limites pour la maison connectée

Google Home limite l'attribution et l'utilisation des ressources, et applique des quotas appropriés pour chaque projet. Les règles spécifiques varient en fonction de la disponibilité des ressources, du profil de l'utilisateur, de l'historique d'utilisation du service et d'autres facteurs. Elles peuvent en outre être modifiées sans préavis.

Limites de l'API HomeGraph

Cette section répertorie les limites de débit pour l'API Google Home Graph. Ces limites s'appliquent aux API REST et RPC.

Google applique la limite par défaut de 6 000 requêtes par tranche de 60 secondes à l'ensemble de vos appels d'API de requête, de synchronisation, de suppression, Report State et de synchronisation de requêtes asynchrones, pour chaque intégration Cloud-to-cloud.

Pour demander une augmentation de quota, contactez ha-certification@google.com en fournissant les informations suivantes :

  • Objet de l'e-mail : Demande d'augmentation du quota de l'API ReportState
  • Contenu de l'e-mail :
    • ID du projet
    • Nom de votre entreprise
    • Quota actuel
    • Raison pour laquelle vous souhaitez augmenter votre quota
Quota Limite Augmentation possible
RequestSync (mode synchrone) Maximum d'une requête simultanée par agentUserId. Non
RequestSync (mode asynchrone) La limite par défaut est de 6 000 requêtes par période de 60 secondes et par intégration Cloud-to-cloud. Oui
Requête La limite par défaut est de 6 000 requêtes par période de 60 secondes et par intégration Cloud-to-cloud. Oui
Synchroniser La limite par défaut est de 6 000 requêtes par période de 60 secondes et par intégration Cloud-to-cloud. Oui
Supprimer La limite par défaut est de 6 000 requêtes par période de 60 secondes et par intégration Cloud-to-cloud. Oui
ReportStateAndNotification La limite par défaut est de 6 000 requêtes par période de 60 secondes et par intégration Cloud-to-cloud. Oui

Déboguer les problèmes de quota

Si votre intégration subit une limitation du débit, suivez les consignes ci-dessous pour diagnostiquer et résoudre les problèmes de quota.

  1. Google limitera le nombre d'appels d'API qui dépassent votre quota. Cela affectera négativement votre intégration en entraînant des incohérences d'état. Par exemple, si une requête ReportStateAndNotification est abandonnée en raison d'une limitation du débit, l'état de l'appareil physique ne sera pas synchronisé, ce qui laissera Google Home app (GHA) avec des informations obsolètes.

  2. Si RequestSync est l'API principale qui rencontre des erreurs, vérifiez que votre service n'essaie pas d'effectuer plusieurs appels simultanés par agentUserId.

  3. Examinez la croissance de votre trafic au fil du temps. Si cette croissance est cohérente avec une augmentation du nombre d'appareils, le lancement d'un nouveau type d'appareil ou un autre lancement prévu, demandez une augmentation du quota. Si cette augmentation est inattendue, examinez votre intégration pour déterminer si un changement inattendu entraîne l'envoi d'un trafic plus important à l'API Home Graph.