È stato implementato un sistema di quote per le API Home per garantire l'affidabilità del servizio e aiutare gli sviluppatori a gestire in modo efficace il volume di traffico. Le quote nelle API Home sono a livello di progetto Google Cloud.
Il limite di frequenza per le API Home è di 30.000 QPM (query al minuto) per progetto. Questo limite comprende tutte le query inviate tramite le API Home.
Quota superata
Quando viene superato il limite di frequenza delle API Home, viene generata un'eccezione
resourceExhaused
HomeException. Le richieste successive verranno rifiutate immediatamente con il messaggio "Quota superata".
Nel caso in cui la quota venga superata, le app devono prevedere un backoff esponenziale e notificare agli utenti se le azioni sono temporaneamente limitate.
Monitoraggio
Utilizza la Console Google Cloud per monitorare l'utilizzo in tempo reale e configurare avvisi proattivi quando ti avvicini a una quota delle API Home.
Per visualizzare le metriche correnti, vai alla sezione Metriche del servizio API Home nel progetto Google Cloud associato alla registrazione dell'app in Google Home Developer Console.
Configurazione degli avvisi
Ti consigliamo di configurare gli avvisi per il superamento di una soglia (ad esempio l'80%) della quota allocata. Il supporto degli avvisi in Google Cloud è molto esteso e altamente configurabile.
Quando crei un avviso per la quota, devi utilizzare le seguenti metriche in Quota consumer > Quota nel generatore di policy.
- Utilizzo della quota di allocazione: serviceruntime.googleapis.com/quota/allocation/usage
- Limite di quota: serviceruntime.googleapis.com/quota/limit
I partner devono anche configurare i canali di notifica (ad esempio l'email) per ricevere avvisi relativi alle quote.
Consulta le seguenti risorse per saperne di più sugli avvisi e sulle notifiche e su come configurarli in Google Cloud:
Richiedi un aumento della quota
Se il traffico legittimo della tua app richiede limiti superiori al limite di frequenza predefinito, puoi richiedere un aumento.
Per visualizzare l'utilizzo e i limiti, vai alla sezione Quote e limiti di sistema del servizio API Home nel progetto Google Cloud associato alla registrazione dell'app in Developer Console.
Per richiedere un aumento, modifica una quota specifica. Per istruzioni, consulta Richiedere una modifica della quota nella Google Cloud documentazione.