Kontingente und Limits für Smart Homes

Google Home begrenzt die Ressourcenzuweisung und -nutzung und setzt entsprechende Kontingente auf Projektbasis durch. 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 API als auch für die RPC API.

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

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

  • Betreff der E-Mail: Anfrage zur Erhöhung des ReportState API-Kontingents
  • E‑Mail-Inhalt:
    • Projekt-ID
    • Name Ihres Unternehmens
    • Aktuelles Kontingent
    • Grund, warum Sie Ihr Kontingent erhöhen möchten
Kontingent 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

Kontingentprobleme beheben

Wenn für Ihre Integration eine Ratenbegrenzung gilt, 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, schlägt die Synchronisierung des Status des physischen Geräts fehl und die Google Home app (GHA) enthält veraltete Informationen.

  2. Wenn RequestSync die primäre API ist, bei der Fehler auftreten, prüfen Sie, ob Ihr Dienst nicht versucht, mehr als einen gleichzeitigen Aufruf pro agentUserId auszuführen.

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