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 werden die Ratenlimits 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 Abfrage, Synchronisierung, Löschung, Report State und asynchrone Anforderungssynchronisierung an, und zwar pro Cloud-to-cloud-Integration.

Wenn Sie eine Kontingenterhöhung anfordern möchten, wenden Sie sich mit den folgenden Informationen an ha-certification@google.com:

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

Kontingentprobleme beheben

Wenn in Ihrer Integration eine Ratenbegrenzung auftritt, 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 kommt. Wenn beispielsweise eine ReportStateAndNotification-Anfrage aufgrund von Ratenbegrenzung verworfen wird, kann der Status des physischen Geräts nicht synchronisiert werden. Das Google Home app (GHA) enthält dann veraltete Informationen.

  2. Wenn bei der primären API RequestSync Fehler auftreten, prüfen Sie, ob Ihr Dienst versucht, mehr als einen gleichzeitigen Aufruf pro agentUserId zu tätigen.

  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, beantragen Sie eine Kontingenterhöhung. Wenn dieser Anstieg unerwartet ist, prüfen Sie Ihre Integration, um festzustellen, ob eine unerwartete Änderung zu mehr Traffic an die Home Graph API führt.