Google Home limita l'allocazione e l'utilizzo delle risorse e applica quote appropriate in base al progetto. I criteri specifici variano a seconda della disponibilità delle risorse, del profilo utente, della cronologia di utilizzo dei servizi e di altri fattori e sono soggetti a modifiche senza preavviso.
Limiti dell'API HomeGraph
Questa sezione elenca i limiti di frequenza per l'API Google Home Graph. Questi limiti si applicano sia all'API REST sia all'API RPC.
Google applica il limite predefinito di 6000 richieste ogni 60 secondi all'aggregato delle chiamate API di query, sincronizzazione, eliminazione, Report State e sincronizzazione delle richieste asincrone, in base all'integrazione di Cloud-to-cloud.
Per richiedere un aumento della quota, contatta ha-certification@google.com con le seguenti informazioni:
- Oggetto dell'email: Richiesta di aumento della quota dell'API ReportState
- Contenuto dell'email:
- ID progetto
- Nome dell'azienda
- Quota attuale
- Motivo per cui vuoi aumentare la quota
| Quota | Limite | Aumentabile |
|---|---|---|
| RequestSync (modalità sincrona) | Massimo 1 richiesta in parallelo per agentUserId.
|
No |
| RequestSync (modalità asincrona) | Limite predefinito di 6000 richieste ogni 60 secondi per integrazione Cloud-to-cloud. | Sì |
| Query | Limite predefinito di 6000 richieste ogni 60 secondi per l'integrazione di Cloud-to-cloud. | Sì |
| Sincronizza | Limite predefinito di 6000 richieste ogni 60 secondi per l'integrazione di Cloud-to-cloud. | Sì |
| Elimina | Limite predefinito di 6000 richieste ogni 60 secondi per l'integrazione di Cloud-to-cloud. | Sì |
| ReportStateAndNotification | Limite predefinito di 6000 richieste ogni 60 secondi per integrazione Cloud-to-cloud. | Sì |
Esegui il debug dei problemi relativi alle quote
Se l'integrazione è soggetta a limitazione di frequenza, utilizza le seguenti linee guida per diagnosticare e risolvere i problemi relativi alla quota:
Google limiterà la frequenza delle chiamate API che superano la tua quota. Ciò influisce negativamente sulla tua integrazione causando mancate corrispondenze di stato. Ad esempio, se una richiesta
ReportStateAndNotificationviene ignorata a causa della limitazione di frequenza, lo stato del dispositivo fisico non verrà sincronizzato, lasciando Google Home app (GHA) con informazioni obsolete.Se l'API principale che presenta errori è
RequestSync, verifica che il tuo servizio non tenti di effettuare più di una chiamata simultanea peragentUserId.Esamina la crescita del traffico nel tempo. Se questa crescita è coerente con un aumento del numero di dispositivi, il lancio di un nuovo tipo di dispositivo o un altro lancio previsto, richiedi un aumento della quota. Se questo aumento è imprevisto, esamina l'integrazione per determinare se una modifica imprevista sta causando l'invio di più traffico all'API Home Graph.