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

Riferimento API Nest

L'API Nest modella una casa o un edificio fisico come una struttura, con Nest Learning Thermostats, Nest Protect e Nest Cam come dispositivi nella struttura. Questa struttura contiene anche informazioni sulla casa nel suo insieme (come lo stato Fuori casa o ETA o le ore di punta attive).

Ogni elemento di dati nella struttura è indirizzabile da un URL di risorsa (chiamato "posizioni dati") in un documento JSON condiviso. Ogni posizione dei dati può memorizzare stringhe, numeri, valori booleani, oggetti padre / figlio o array.

Esplora il modello di dati con questo riferimento API interattivo .

Dall'API, puoi sincronizzare i dati da posizioni a più livelli nel modello di dati, ad esempio:

  • un'intera struttura, inclusi tutti i dispositivi
  • un unico dispositivo in una struttura
  • un gruppo di valori di dati (corrente e temperatura ambiente)
  • un singolo valore di dati (stato di salute della batteria)

I tuoi prodotti dovrebbero rispondere in modo ponderato a eventi come questi:

Tuttavia, tieni presente che ciascuno degli oggetti basati su dispositivo funziona con vincoli del mondo reale. Ad esempio, il termostato non deve far funzionare il condizionatore d'aria quando è abilitato il riscaldamento di emergenza. La nostra API è progettata per salvaguardare sia i nostri dispositivi che la casa dell'utente e impedirà determinate azioni se sarebbero sorprendenti o pericolose.

Autorizzazioni e dati del dispositivo condiviso

La capacità di leggere o scrivere in una posizione dati è controllata dalle autorizzazioni. I gruppi di autorizzazioni forniscono accesso in lettura, scrittura o lettura / scrittura a valori di dati selezionati in dispositivi e strutture.

Per ulteriori informazioni, vedere la panoramica delle autorizzazioni .

Dati e privacy

I dati relativi ai prodotti per la casa possono essere molto personali. I dati del sensore domestico contengono informazioni su come le persone vivono la propria vita nel proprio spazio personale. La sicurezza e la gestione di tali dati sono molto importanti e un obiettivo significativo per Nest. Rendiamo chiaro agli utenti che tipo di dati abbiamo, come vengono utilizzati e dove possono controllarli.

Ulteriori informazioni sulle nostre opinioni sulla privacy .

Metadati

I metadati sono informazioni aggiuntive fornite quando si effettua una chiamata all'endpoint a livello di root:

https://developer-api.nest.com/

token di accesso

Dopo l'autorizzazione dell'utente, il prodotto utilizza un token di accesso per effettuare chiamate API al servizio Nest. Questo token di accesso serve come prova che un utente ha autorizzato il tuo prodotto a effettuare chiamate per suo conto.

Dettagli
ritorna string
Esempio: "c.FmDPkzyzaQe ..."

client_version

La versione client è l'ultima versione autorizzata dall'utente di un client ed è associata a un access_token .

Quando si aggiornano le autorizzazioni per un client, la versione del client viene incrementata e l'utente viene informato che è disponibile un aggiornamento. Gli utenti devono accettare questo aggiornamento client prima di poter utilizzare il prodotto aggiornato.

Dettagli
ritorna number
Esempi: 1, 17, 42

ID utente

L'ID utente consente di identificare gli utenti attraverso le chiamate API. Questo identificatore è diverso per ogni prodotto Works with Nest e combinazione di utenti.

Ad esempio, se l'utente 1 ha autorizzato il prodotto Works with Nest A e il prodotto Works with Nest B, il prodotto A ha un valore user_id per l'utente 1 e il prodotto B ha un valore user_id diverso per l'utente 1.

Dettagli
ritorna string
Esempio: z.1.1.7DHps ...