Google Home limita l'allocazione e l'utilizzo delle risorse e applica quote appropriate in base al singolo 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 Cloud-to-cloud.
Per richiedere un aumento della quota, contatta ha-certification@google.com fornendo le seguenti informazioni:
- Oggetto 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 una 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 integrazione Cloud-to-cloud. | Sì |
| Sincronizza | Limite predefinito di 6000 richieste ogni 60 secondi per integrazione Cloud-to-cloud. | Sì |
| Elimina | Limite predefinito di 6000 richieste ogni 60 secondi per integrazione Cloud-to-cloud. | Sì |
| ReportStateAndNotification | Limite predefinito di 6000 richieste ogni 60 secondi per integrazione Cloud-to-cloud. | Sì |
Eseguire il debug dei problemi relativi alla quota
Se la tua integrazione è soggetta a limitazione della 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 quota. Ciò influisce negativamente sulla tua integrazione causando mancate corrispondenze di stato. Ad esempio, se una richiesta
ReportStateAndNotificationviene eliminata a causa della limitazione della frequenza, la sincronizzazione dello stato del dispositivo fisico non riuscirà, lasciando Google Home app (GHA) con informazioni obsolete.Se
RequestSyncè l'API principale che riscontra errori, 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 è inatteso, rivedi l'integrazione per determinare se una modifica imprevista sta causando l'invio di più traffico all'API Home Graph.