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 für die Home APIs überschritten wird, wird ein resourceExhaused-Fehler HomeError ausgegeben. 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 werden.

Monitoring

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

Wenn Sie sich die aktuellen Messwerte ansehen möchten, rufen Sie im Google Cloud-Projekt, das mit der Registrierung Ihrer App in Google Home Developer Console verknüpft ist, den Abschnitt „Messwerte“ des Home API-Dienstes auf.

Warnungen einrichten

Wir empfehlen Partnern, Benachrichtigungen einzurichten, wenn ein Schwellenwert (z. B. 80%) des zugewiesenen Kontingents überschritten wird. Die Unterstützung von Benachrichtigungen in Google Cloud ist sehr umfangreich und lässt sich in hohem Maße konfigurieren.

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

  • Nutzung von Zuteilungskontingenten – serviceruntime.googleapis.com/quota/allocation/usage
  • Kontingentlimit – serviceruntime.googleapis.com/quota/limit

Partner sollten auch Benachrichtigungskanäle wie E‑Mail einrichten, um Kontingentwarnungen zu erhalten.

Weitere Informationen zu Benachrichtigungen und dazu, wie Sie sie in Google Cloud konfigurieren, finden Sie in den folgenden Ressourcen:

Kontingenterhöhung anfordern

Wenn Ihre App legitimen Traffic hat, der höhere Limits als das Standardratenlimit 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.