Kontingentverwaltung

Für die Home APIs wurde ein Kontingentsystem implementiert, um die Zuverlässigkeit des Dienstes zu gewährleisten und Entwicklern zu helfen, das Trafficvolumen effektiv zu verwalten. 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 Anfragen, die über die Home APIs gesendet werden.

Kontingent überschritten

Wenn das Ratenlimit der Home APIs überschritten wird, wird eine 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 beobachten und proaktive Benachrichtigungen konfigurieren, wenn Sie sich einem Kontingent der Home APIs nähern.

Die aktuellen Messwerte finden Sie im Bereich Messwerte des Home API-Dienstes im Google Cloud Projekt, das mit der Registrierung Ihrer App in Google Home Developer Console verknüpft ist.

Warnungen einrichten

Wir empfehlen Partnern, Warnungen einzurichten, wenn ein bestimmter Prozentsatz des zugewiesenen Kontingents erreicht wird (z. B. 80%). Die Warnungsunterstützung in Google Cloud ist sehr umfangreich und hochgradig konfigurierbar.

Wenn Sie eine Warnung für das Kontingent erstellen, verwenden Sie im Richtlinien-Builder die folgenden Messwerte unter Nutzerkontingent > Kontingent.

  • Nutzung des Zuteilungskontingents – serviceruntime.googleapis.com/quota/allocation/usage
  • Kontingentlimit – serviceruntime.googleapis.com/quota/limit

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

Weitere Informationen zu Warnungen und Benachrichtigungen sowie zur Konfiguration in Google Cloud finden Sie in den folgenden Ressourcen:

Kontingenterhöhung anfordern

Wenn Ihre App legitimen Traffic hat, für den höhere Limits als das Standardratenlimit erforderlich sind, können Sie eine Erhöhung anfordern.

Nutzung und Limits finden Sie im Bereich Kontingente und Systemlimits des Home API-Dienstes in dem Google Cloud Projekt, das mit der Registrierung Ihrer App verknüpft ist in Developer Console.

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.