Kontingente und Limits für Smart Homes

Google Home begrenzt die Ressourcenzuweisung und ‑nutzung und legt geeignete Kontingente pro Projekt fest. Die einzelnen Richtlinien variieren je nach Ressourcenverfügbarkeit, Nutzerprofil, Dienstnutzungsverlauf sowie weiteren Faktoren und können ohne Vorankündigung geändert werden.

HomeGraph API-Limits

In diesem Abschnitt sind die Ratenbegrenzungen für die Google Home Graph API aufgeführt. Diese Limits gelten sowohl für die REST als auch für die RPC API.

Google wendet das Standardlimit von 6.000 Anfragen pro 60 Sekunden auf die Gesamtheit Ihrer API-Aufrufe für Abfragen, Synchronisierungen, Löschungen, Report State, und asynchrone Anfragen an. Dies gilt für jede Cloud-to-cloud Integration.

Wenn Sie eine Kontingenterhöhung beantragen möchten, senden Sie eine E‑Mail mit den folgenden Informationen an ha-certification@google.com:

  • Betreff der E‑Mail: Request to increase ReportState API Quota (Antrag auf Erhöhung des Kontingents für die ReportState API)
  • Inhalt der E‑Mail:
    • Projekt-ID
    • Name Ihres Unternehmens
    • Aktuelles Kontingent
    • Grund für den Antrag auf Kontingenterhöhung
Quota Limit Kann erhöht werden
RequestSync (synchroner Modus) Maximal 1 gleichzeitige Anfrage pro agentUserId. Nein
RequestSync (asynchroner Modus) Standardlimit von 6.000 Anfragen pro 60 Sekunden pro Cloud-to-cloud Integration. Ja
Abfrage Standardlimit von 6.000 Anfragen pro 60 Sekunden pro Cloud-to-cloud Integration. Ja
Synchronisieren Standardlimit von 6.000 Anfragen pro 60 Sekunden pro Cloud-to-cloud Integration. Ja
Löschen Standardlimit von 6.000 Anfragen pro 60 Sekunden pro Cloud-to-cloud Integration. Ja
ReportStateAndNotification Standardlimit von 6.000 Anfragen pro 60 Sekunden pro Cloud-to-cloud Integration. Ja

Probleme mit Kontingenten beheben

Wenn bei Ihrer Integration Ratenbegrenzungen auftreten, können Sie die folgenden Richtlinien verwenden, um Kontingentprobleme zu diagnostizieren und zu beheben:

  1. Google begrenzt die Rate von API-Aufrufen, die Ihr Kontingent überschreiten. Dies wirkt sich negativ auf Ihre Integration aus, da es zu Statusabweichungen führt. Wenn beispielsweise eine ReportStateAndNotification Anfrage aufgrund einer Ratenbegrenzung verworfen wird, kann der Status des physischen Geräts nicht synchronisiert werden. In der Google Home app (GHA) werden dann veraltete Informationen angezeigt.

  2. Wenn bei der RequestSync-API hauptsächlich Fehler auftreten, prüfen Sie, ob Ihr Dienst nicht mehr als einen gleichzeitigen Aufruf pro agentUserId ausführt.

  3. Sehen Sie sich die Entwicklung Ihres Traffics im Zeitverlauf an. Wenn diese Entwicklung mit einer Zunahme der Anzahl der Geräte, der Einführung eines neuen Gerätetyps oder einer anderen erwarteten Einführung übereinstimmt, beantragen Sie eine Kontingenterhöhung. Wenn diese Zunahme unerwartet ist, überprüfen Sie Ihre Integration, um festzustellen, ob eine unerwartete Änderung dazu führt, dass mehr Traffic an die Home Graph API gesendet wird.