Gestion des quotas

Un système de quotas a été implémenté pour les API Home afin de garantir 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 Google Cloud projet.

La limite de débit 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 resourceExhaused HomeException est générée. Les requêtes suivantes sont immédiatement rejetées avec le message "Quota dépassé".

En cas de dépassement du quota, les applications doivent implémenter 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 des API Home.

Pour afficher les métriques actuelles, accédez à la section Métriques du service de l'API Home 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 lorsqu'un seuil (par exemple, 80%) du quota alloué est atteint. 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 des 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 :

Demander une augmentation du quota

Si le trafic légitime de votre application nécessite des limites supérieures à 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 de l'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 obtenir des instructions, consultez Demander un ajustement de quota dans la documentation Google Cloud.