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 Protects e Nest Cams come dispositivi nella struttura. Questa struttura contiene anche informazioni sulla casa nel suo insieme (come lo stato assente o ETA o le ore di punta attive).

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

Esplora il modello di dati con questo riferimento API interattivo .

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

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

I tuoi prodotti dovrebbero rispondere pensosamente ad eventi come questi:

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

Autorizzazioni e dati del dispositivo condivisi

La capacità di leggere o scrivere in un percorso dati è controllata da autorizzazioni. I gruppi di autorizzazioni forniscono accesso in lettura, scrittura o lettura / scrittura ai valori di dati selezionati in dispositivi e strutture.

Per ulteriori informazioni, vedere 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 focus significativo su 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 avvisato della disponibilità di 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 differisce per ogni combinazione di prodotto e utente di Works with Nest.

Ad esempio, se l'utente 1 ha autorizzato il prodotto A di Works con Nest e il prodotto B di Works con Nest, 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 ...