Per le API per la casa è stato implementato un sistema di quote 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 il limite di frequenza delle API Home viene superato, viene generato un
resourceExhaused
HomeException. Le richieste successive verranno rifiutate
immediatamente con un messaggio "Quota superata".
Nel caso in cui la quota venga superata, le app devono prevedere un backoff esponenziale e avvisare gli utenti se le azioni sono temporaneamente limitate.
Monitoraggio
Utilizza la console Google Cloud per monitorare l'utilizzo in tempo reale e configurare avvisi proattivi per quando ti avvicini a una quota delle API per la casa.
Per visualizzare le metriche attuali, vai alla sezione Metriche del servizio API Home nel progetto Google Cloud associato alla registrazione della tua app in Google Home Developer Console.
Configurazione degli avvisi
Consigliamo ai partner di configurare avvisi per il superamento di una soglia (ad esempio l'80%) della quota allocata. Il supporto degli avvisi in Google Cloud è molto ampio 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 canali di notifica (ad esempio l'email) per ricevere avvisi relativi alla quota.
Consulta le seguenti risorse per scoprire di più su avvisi e notifiche e su come configurarli in Google Cloud:
Richiedi un aumento della quota
Se la tua app ha un traffico legittimo che richiede limiti superiori a quelli predefiniti, 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 della tua app in Developer Console.
Per richiedere un aumento, modifica una quota specifica. Per istruzioni, consulta Richiedi un aggiustamento delle quote nella documentazione di Google Cloud.