Device Access I progetti sono limitati da limiti di utenti, struttura e frequenza a seconda dell'ambiente e del tipo di offerta commerciale.
Vogliamo che gli sviluppatori creino esperienze utente interessanti, ma vogliamo anche Il servizio e i dispositivi Nest devono essere sempre disponibili per l'utente. Integrazioni effettuare un numero elevato di richieste in un determinato periodo di tempo può influire negativamente sul servizio e sui dispositivi, per cui l'API SDM applica dei limiti di frequenza. La limitazione di frequenza limita il numero di chiamate API per un determinato periodo di tempo e previene l'uso eccessivo delle risorse.
Limiti per ambiente
Tutti i progetti iniziano nell'ambiente Sandbox . La sandbox destinati alla valutazione dell'API SDM e all'uso personale e vengono limitati di conseguenza. Ambienti con basi utenti più ampie, come Sviluppo commerciale , hanno limiti diversi.
Limiti relativi agli utenti della sandbox
Un account sviluppatore nella sandbox è limitato a 25 utenti su 5 in tutti i progetti. Esiste un limite di 3 progetti per account.
Le strutture sono limitate a 5 utenti ciascuna, quindi verrà raggiunto solo questo limite una volta raggiunte tutte e 5 le strutture con 5 utenti ciascuna. L'account sviluppatore (che possiede il progetto) non viene conteggiato ai fini del limite di 5 utenti per un alla struttura del centro di costo.
Al contrario, se un progetto ha 15 utenti su 5 strutture, gli utenti aggiuntivi possono essere aggiunto solo alle 5 strutture esistenti, poiché il limite della struttura è è già stato raggiunto.
Limiti di frequenza della sandbox
La sandbox è limitata a 3 livelli diversi. I limiti sono impostati su query al minuto (QPM) se non diversamente specificato.
Livello API
Le chiamate API sono limitate per progetto e per utente. Consulta l'API Riferimento per ulteriori informazioni sulle singole di machine learning.
Metodo API | Limite di frequenza |
---|---|
devices.executeCommand |
10 Q/M |
devices.get |
10 Q/M |
devices.list |
5 Q/M |
structures.get |
5 Q/M |
structures.list |
5 Q/M |
structures.rooms.get |
5 Q/M |
structures.rooms.list |
5 Q/M |
Livello di comando
Ogni comando trait (devices.executeCommand
) è limitato a 5 QPM per progetto
per utente e per dispositivo.
Ciò significa che se un progetto ha 2 utenti con 2 dispositivi ciascuno (4 dispositivi in totale), lo stesso comando può essere chiamato cinque volte al minuto per ognuno dei quattro dispositivi.
Tuttavia, se un progetto ha 2 utenti con 3 dispositivi ciascuno per 6 dispositivi totali,
lo stesso comando non è stato chiamato 5 volte al minuto per ognuna delle 6
dispositivi mobili. Questo genererebbe 15 QPM per ogni utente,
Il limite di frequenza a livello di API di devices.executeCommand
per l'utente di un progetto è 10 QPM.
Livello di istanza dispositivo
Inoltre, i limiti a livello di istanza dei dispositivi vengono implementati nei vari progetti
(devices.executeCommand
) per la protezione della batteria del dispositivo. Questi limiti
vengono applicate sia a livello di QPM sia a livello di query all'ora e non si applicano
ai metodi API get
e list
.
Ad esempio, supponiamo che il progetto A e il progetto B abbiano entrambi accesso allo stesso dispositivo, Dispositivo A (ad esempio, l'utente ha autorizzato due diverse integrazioni che utilizzano lo stesso dispositivo). Se il progetto A ha inviato 4 comandi a Dispositivo A entro un minuto, il progetto B può inviare un solo comando al dispositivo A in lo stesso minuto prima che venga raggiunto il limite di frequenza a livello di istanza del dispositivo. In quel caso i comandi da entrambi i progetti al Dispositivo A vengono limitati il minuto iniziato con il primo comando al Dispositivo A.
Se un tipo di dispositivo non è elencato di seguito, non ha un livello di istanza del dispositivo. limiti di frequenza.
Tipo di dispositivo | Limite di frequenza delle istanze del dispositivo |
---|---|
TERMOSTATO | 5 QPM o 100 QPH |
FOTOCAMERA | 30 QPM o 100 QPH |
DOORBELL | 30 QPM o 100 QPH |
Errori
Potrebbero essere restituiti i seguenti codici di errore in relazione a questa guida:
Messaggio di errore | RPC | Risoluzione dei problemi |
---|---|---|
Tariffa limitata. | RESOURCE_EXHAUSTED |
Ogni sviluppatore ha una quota che limita il numero di chiamate che può effettuare. Se effettui più chiamate rispetto alla tua quota, riceverai il messaggio Limitazione di frequenza. Per risolvere il problema, invia nuovamente la chiamata una volta scaduta la quota. |
Consulta la documentazione sul codice di errore API per l'elenco completo dei codici di errore dell'API.