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'Cloud-to-cloud integrazione.
Per richiedere un aumento della quota, contatta ha-certification@google.com fornendo le seguenti informazioni:
- Oggetto dell'email: Request to increase ReportState API Quota
- 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 Cloud-to-cloud integrazione. | Sì |
| Query | Limite predefinito di 6000 richieste ogni 60 secondi per Cloud-to-cloud integrazione. | Sì |
| Sincronizza | Limite predefinito di 6000 richieste ogni 60 secondi per Cloud-to-cloud integrazione. | Sì |
| Elimina | Limite predefinito di 6000 richieste ogni 60 secondi per Cloud-to-cloud integrazione. | Sì |
| ReportStateAndNotification | Limite predefinito di 6000 richieste ogni 60 secondi per Cloud-to-cloud integrazione. | Sì |
Eseguire il debug dei problemi relativi alla quota
Se la tua integrazione riscontra limitazioni 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 quota. Ciò influisce negativamente sull'integrazione, causando mancate corrispondenze di stato. Ad esempio, se una
ReportStateAndNotificationrichiesta viene eliminata a causa della limitazione di frequenza, lo stato del dispositivo fisico non verrà sincronizzato, lasciando l' Google Home app (GHA) con informazioni obsolete.Se
RequestSyncè l'API principale che riscontra errori, controlla che il tuo servizio non tenti di effettuare più di una chiamata in parallelo 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.