Gestion des quotas

Un système de quotas a été mis en place 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 projet Google Cloud.

La limite de débit pour les API Home est de 30 000 RPM (requêtes par minute) 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 exception resourceExhaused HomeException est générée. Les requêtes suivantes seront immédiatement rejetées avec un message "Quota dépassé".

En cas de dépassement du quota, les applications doivent appliquer un intervalle exponentiel entre les tentatives et avertir 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 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 compatibilité 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 client > Quota dans le générateur de règles.

  • Utilisation des quotas 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 (comme les e-mails) pour recevoir des alertes de quota.

Consultez les ressources suivantes pour en savoir plus sur les alertes et les notifications, et sur la façon de les configurer dans Google Cloud :

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 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 savoir comment procéder, consultez Demander un ajustement de quota dans la documentation Google Cloud.