Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

L'architettura dell'API Nest

Informazioni sul servizio Nest

Le applicazioni Nest consentono agli utenti di connettersi con la propria casa ovunque si trovino. Tutti i dispositivi Nest (termostati, protezioni e videocamere) e le applicazioni (iOS, Android e app Web) si collegano al servizio Nest.

Esempio da cloud a cloud

Il servizio Nest fornisce un modello di dati della casa. I dispositivi e le applicazioni leggono da questo modello di dati per intraprendere le azioni appropriate. Aggiornano il modello di dati per riflettere i cambiamenti nel sistema.

Ad esempio, un termostato legge la sua temperatura target dal modello di dati. Imposta la temperatura ambiente sulla sua misurazione corrente e invia i dati del sensore a Home / Away Assist, che regola di conseguenza la modalità struttura.

I dispositivi Nest funzionano in ambienti limitati. L'alimentazione è limitata e la connettività della rete domestica può essere inaffidabile. I tuoi prodotti e servizi possono sfruttare i nostri algoritmi di dispositivo per offrire agli utenti un'esperienza domestica semplice e intuitiva.

Il modello di dati

L'API Nest è rappresentata come documento JSON con attributi di livello superiore di metadata , devices e structures . I tuoi prodotti Works con Nest utilizzano questo documento JSON per interagire e reagire con i dispositivi Nest e le relative modifiche di stato.

Le structures nido rappresentano le structures fisiche nel mondo reale. Servono come punto di organizzazione per i devices e archiviano i dati per l'intero edificio. In genere, una structure è una casa dell'utente.

I devices Nest rappresentano devices fisici (termostati, protezioni e telecamere) all'interno di una struttura.

Ogni elemento di dati nel documento JSON è indirizzabile tramite URL (noto anche come "percorsi di dati"). Funziona con i prodotti Nest in grado di leggere e scrivere in sezioni di questo documento e iscriversi alle modifiche. Questa funzionalità di abbonamento consente a Works con i prodotti Nest di reagire in tempo reale alle modifiche apportate al sistema, ad esempio lo spegnimento delle luci quando un utente imposta la struttura su Assente.

Gli oggetti funzionano anche sotto vincoli del mondo reale. Il modello di dati protegge i dispositivi e la casa dell'utente prevenendo azioni sorprendenti e pericolose. Ad esempio, il termostato non esegue il condizionatore d'aria quando è abilitato il riscaldamento di emergenza.

Esplora il modello di dati con questo riferimento API interattivo .

Stato previsto

Il servizio Nest memorizza lo stato autorevole del sistema e funziona con i prodotti Nest sottoscrivere le modifiche. La modifica di questo stato (ad esempio, per modificare la temperatura target di un termostato) fa sì che il servizio invii una notifica di modifica a tutti gli abbonati.

Poiché questa propagazione presenta alcuni ritardi e le reti possono essere inaffidabili, lo stato osservato da un prodotto potrebbe non essere lo stato attualmente osservato da altri prodotti o servizi. Lo stato viene infine sincronizzato quando i messaggi vengono trasmessi tra vari prodotti.

Questo modello di pubblicazione / sottoscrizione orientato ai documenti fornisce interazioni reattive con le applicazioni.

Utilizzando il servizio Nest

Per accedere agli endpoint REST nel servizio Nest, utilizzare HTTPS nel prodotto. Esistono molte librerie client di terze parti che possono essere utilizzate per questo scopo.

Autorizzazioni e autorizzazioni

Vogliamo consentire agli sviluppatori di creare prodotti e servizi che migliorino le case, senza compromettere la privacy e la sicurezza degli utenti. Tutte le nostre comunicazioni sono sicure e l'autorizzazione ad accedere ai dati è sempre esplicitamente concessa dall'utente. Per ulteriori informazioni, consultare la panoramica delle autorizzazioni .

L'autorizzazione è gestita dal protocollo OAuth 2.0. Quando un utente accetta di fornire l'accesso al livello di autorizzazione richiesto, Nest autentica la richiesta e un token di accesso viene concesso al richiedente. Tale token di accesso può essere utilizzato per accedere all'API Nest e interagire con le strutture e i dispositivi dell'utente.

La concessione di un token di accesso stabilisce una relazione di fiducia tra un utente, un prodotto Works with Nest e Nest. Gli utenti possono revocare l'accesso in qualsiasi momento.

Per informazioni su come autorizzare una connessione all'API Nest, vedere Panoramica delle autorizzazioni .