Quotas et limites pour la maison connectée

Google Home impose des limites à 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 utilisateur, de l'historique d'utilisation du service et d'autres facteurs, et sont susceptibles d'être modifiées sans préavis.

Limites de l'API HomeGraph

Cette section liste les limites de débit de 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 toutes les 60 secondes à l'ensemble de vos appels d'API de requête, de synchronisation, de suppression, Report State et de synchronisation des requêtes asynchrones, par 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) Limite par défaut de 6 000 requêtes toutes les 60 secondes par intégration Cloud-to-cloud. Oui
Requête Limite par défaut de 6 000 requêtes toutes les 60 secondes par intégration Cloud-to-cloud. Oui
Synchroniser Limite par défaut de 6 000 requêtes toutes les 60 secondes par intégration Cloud-to-cloud. Oui
Supprimer Limite par défaut de 6 000 requêtes toutes les 60 secondes par intégration Cloud-to-cloud. Oui
ReportStateAndNotification Limite par défaut de 6 000 requêtes toutes les 60 secondes par intégration Cloud-to-cloud. Oui

Déboguer les problèmes de quota

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

  1. Google limitera le débit des appels d'API qui dépassent votre quota. Cela a un impact négatif sur votre intégration en provoquant 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 plus d'un appel simultané 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 attendu, demandez une augmentation de 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 vers l'API Home Graph.