Kontingentverwaltung

Für die Home APIs wurde ein Kontingentsystem implementiert, um die Zuverlässigkeit des Dienstes zu gewährleisten und Entwicklern die effektive Verwaltung des Trafficvolumens zu ermöglichen. Kontingente in den Home APIs gelten auf Google Cloud-Projektebene.

Das Ratenlimit für die Home APIs beträgt 30.000 Anfragen pro Minute und Projekt. Dieses Limit umfasst alle Abfragen, die über die Home APIs gesendet werden.

Kontingent überschritten

Wenn die Ratenbegrenzung der Home APIs überschritten wird, wird ein resourceExhaused HomeException ausgelöst. Nachfolgende Anfragen werden sofort mit der Meldung „Kontingent überschritten“ abgelehnt.

Wenn das Kontingent überschritten wird, sollten Apps einen exponentiellen Backoff verwenden und Nutzer benachrichtigen, wenn Aktionen vorübergehend eingeschränkt sind.

Monitoring

In der Google Cloud Console können Sie die Nutzung in Echtzeit überwachen und proaktive Benachrichtigungen konfigurieren, die Sie erhalten, wenn Sie sich einem Home APIs-Kontingent nähern.

Aktuelle Messwerte findest du im Google Cloud-Projekt, das mit der Registrierung deiner App in Google Home Developer Console verknüpft ist, im Abschnitt Messwerte des Home API-Dienstes.

Warnungen einrichten

Wir empfehlen Partnern, Benachrichtigungen für das Überschreiten eines Schwellenwerts (z. B. 80%) des zugewiesenen Kontingents einzurichten. Die Unterstützung von Benachrichtigungen in Google Cloud ist sehr umfangreich und hochgradig konfigurierbar.

Wenn Sie eine Benachrichtigung für ein Kontingent erstellen, sollten Sie im Policy Builder die folgenden Messwerte unter Nutzerkontingent > Kontingent verwenden.

  • Zuteilungskontingentnutzung – serviceruntime.googleapis.com/quota/allocation/usage
  • Kontingentlimit – serviceruntime.googleapis.com/quota/limit

Partner sollten auch Benachrichtigungskanäle (z. B. E-Mail) einrichten, um Kontingentbenachrichtigungen zu erhalten.

In den folgenden Ressourcen finden Sie weitere Informationen zu Benachrichtigungen und deren Konfiguration in Google Cloud:

Kontingenterhöhung anfordern

Wenn Ihre Anwendung legitimen Traffic hat, der höhere Limits als das Standard-Ratenlimit erfordert, können Sie eine Erhöhung beantragen.

Wenn Sie die Nutzung und die Limits aufrufen möchten, rufen Sie im Google Cloud-Projekt, das mit der Registrierung Ihrer App in Developer Console verknüpft ist, den Abschnitt Kontingente und Systemlimits des Home API-Dienstes auf.

Wenn Sie eine Erhöhung anfordern möchten, bearbeiten Sie ein bestimmtes Kontingent. Eine Anleitung finden Sie in der Google Cloud-Dokumentation unter Kontingentanpassung anfordern.