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 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 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 Cloud-to-cloud intégration.
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 l'entreprise
- Quota actuel
- Motif de votre demande d'augmentation de 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 par 60 secondes pour chaque Cloud-to-cloud intégration. | Oui |
| Requête | Limite par défaut de 6 000 requêtes par 60 secondes pour chaque Cloud-to-cloud intégration. | Oui |
| Synchroniser | Limite par défaut de 6 000 requêtes par 60 secondes pour chaque Cloud-to-cloud intégration. | Oui |
| Supprimer | Limite par défaut de 6 000 requêtes par 60 secondes pour chaque Cloud-to-cloud intégration. | Oui |
| ReportStateAndNotification | Limite par défaut de 6 000 requêtes par 60 secondes pour chaque Cloud-to-cloud intégration. | Oui |
Déboguer les problèmes de quota
Si votre intégration est limitée en termes de débit, suivez les consignes ci-dessous pour diagnostiquer et résoudre les problèmes de quota :
Google limite le débit des appels d'API qui dépassent votre quota. Cela a un impact négatif sur votre intégration, car cela entraîne des incohérences d'état. Par exemple, si une
ReportStateAndNotificationrequête est abandonnée en raison d'une limitation du débit, l'état de l'appareil physique ne sera pas synchronisé, ce qui laissera le Google Home app (GHA) avec des informations obsolètes.Si
RequestSyncest l'API principale qui rencontre des erreurs, vérifiez que votre service n'essaie pas d'effectuer plus d'un appel simultané paragentUserId.Examinez l'évolution de votre trafic au fil du temps. Si cette croissance correspond à une augmentation du nombre d'appareils, au lancement d'un nouveau type d'appareil ou à un autre lancement prévu, 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 de davantage de trafic à l'API Home Graph.