Un système de quotas a été mis en place pour les API Home afin d'assurer la fiabilité du service et d'aider les développeurs à gérer efficacement le volume de trafic. Les quotas des API Home sont définis au niveau du projet Google Cloud.
La limite de fréquence pour les API Home est de 30 000 requêtes par minute et par projet. Cette limite englobe toutes les requêtes envoyées via les API Home.
Quota dépassé
Lorsque la limite de débit des API Home est dépassée, une erreur resourceExhaused
HomeError est générée. Les requêtes suivantes seront immédiatement refusées et un message "Quota dépassé" s'affichera.
Si le quota est dépassé, les applications doivent utiliser un algorithme de backoff exponentiel et informer les utilisateurs si les actions sont temporairement limitées.
Surveillance
Utilisez la console Google Cloud pour surveiller l'utilisation en temps réel et configurer des alertes proactives lorsque vous approchez d'un quota d'API Home.
Pour afficher les métriques actuelles, accédez à la section Métriques du service Home API dans le projet Google Cloud associé à l'enregistrement de votre application dans Google Home Developer Console.
Configurer des alertes
Nous recommandons aux partenaires de configurer des alertes pour le dépassement d'un seuil (par exemple, 80 %) de leur quota alloué. La prise en charge des alertes dans Google Cloud est très étendue et hautement configurable.
Lorsque vous créez une alerte pour un quota, vous devez utiliser les métriques suivantes sous Quota du client > Quota dans le générateur de règles.
- Utilisation du quota d'allocation : serviceruntime.googleapis.com/quota/allocation/usage
- Limite de quota : serviceruntime.googleapis.com/quota/limit
Les partenaires doivent également configurer des canaux de notification (par exemple, par e-mail) pour recevoir les alertes de quota.
Pour en savoir plus sur les alertes et les notifications, et sur la façon de les configurer dans Google Cloud, consultez les ressources suivantes :
- Créer des règles d'alerte basées sur un seuil de métrique
- Créer et gérer des chaînes de notification
Demander une augmentation du quota
Si votre application génère un trafic légitime qui nécessite des limites plus élevées que la limite de débit par défaut, vous pouvez demander une augmentation.
Pour afficher l'utilisation et les limites, accédez à la section Quotas et limites du système du service API Home dans le projet Google Cloud associé à l'enregistrement de votre application dans Developer Console.
Pour demander une augmentation, modifiez un quota spécifique. Pour savoir comment procéder, consultez Demander un ajustement de quota dans la documentation Google Cloud.