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

API della struttura

Gli utenti possono aggiungere un massimo di tre strutture , con più dispositivi per struttura.

Tutti i valori seguenti si trovano sotto ogni structures/ structure_id nel documento JSON.

struttura_id

Numero identificativo della struttura. Quando si effettua una chiamata a questa posizione dati, è possibile accedere ai valori dei dati in questa struttura.

Dettagli
https://developer-api.nest.com/structures/ structure_id /structure_id
ritorna string
Esempio: "VqFabWH21nw ..."
Accesso sola lettura
Disponibile in Lettura termostato / v1-v6
Termostato lettura / scrittura / v1-v6
Fumo + CO letto / v1-v5
Lettura fuori casa / v1-v2
Lettura / scrittura assente / v1-v2
Scrittura ETA / v1-v2
Codice postale letto / v2
Lettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Fotocamera lettura / scrittura / v1-v3
Fotocamera lettura / scrittura + immagini / v1-v4
Energia letta / v2

termostati

Elenco dei termostati nella struttura, per identificatore univoco del dispositivo. Questo è un array di oggetti JSON che include tutti i termostati nella struttura.

Dettagli
https://developer-api.nest.com/structures/ structure_id /thermostats
ritorna array
Esempio: [ "peyiJNo0IldT2YlIVtYaGQ",... ]
Accesso sola lettura
Disponibile in Lettura termostato / v1-v6
Termostato lettura / scrittura / v1-v6
Fumo + CO letto / v1-v5
Lettura fuori casa / v1-v2
Lettura / scrittura assente / v1-v2
Scrittura ETA / v1-v2
Lettura fotocamera / v2-v3
Lettura fotocamera + immagini / v2-v4
Fotocamera lettura / scrittura / v2-v3
Fotocamera lettura / scrittura + immagini / v2-v4

smoke_co_alarms

Elenco degli allarmi fumo + CO nella struttura, per identificatore univoco del dispositivo. Si tratta di un array di oggetti JSON che include tutti gli allarmi fumo + CO nella struttura.

Dettagli
https://developer-api.nest.com/structures/ structure_id /smoke_co_alarms
ritorna array
Esempio: [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ]
Accesso sola lettura
Disponibile in Lettura termostato / v1-v6
Termostato lettura / scrittura / v1-v6
Fumo + CO letto / v1-v5
Lettura fuori casa / v1-v2
Lettura / scrittura assente / v1-v2
Scrittura ETA / v1-v2
Lettura fotocamera / v2-v3
Lettura fotocamera + immagini / v2-v4
Fotocamera lettura / scrittura / v2-v3
Fotocamera lettura / scrittura + immagini / v2-v4

macchine fotografiche

Elenco delle telecamere nella struttura, per identificatore univoco del dispositivo. Si tratta di un array di oggetti JSON che include tutte le telecamere nella struttura.

Dettagli
https://developer-api.nest.com/structures/ structure_id /cameras
ritorna array
Esempio: [ "awJo6rH...",... ]
Accesso sola lettura
Disponibile in Lettura termostato / v4-v6
Termostato lettura / scrittura / v4-v6
Fumo + CO letto / v4-v5
Lettura fuori casa / v2
Lettura / scrittura assente / v2
ETA write / v2
Lettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Fotocamera lettura / scrittura / v1-v3
Fotocamera lettura / scrittura + immagini / v1-v4

lontano

Indica lo stato di occupazione della struttura.

Le strutture hanno due stati legati alla presenza: in home o away . Quando non viene rilevato alcun movimento in casa, la struttura cambierà da home a away .

Dettagli
https://developer-api.nest.com/structures/ structure_id /away
ritorna string
Valori: "home", "away"
Accesso leggere scrivere
Disponibile in Leggere:
Lettura termostato / v1-v6
Termostato lettura / scrittura / v1-v6
Fumo + CO letto / v1-v5
Lettura fuori casa / v1-v2
Lettura / scrittura assente / v1-v2
Scrittura ETA / v1-v2
Scrivi:
Lettura / scrittura assente / v1-v2

nome

Nome visualizzato della struttura definito dall'utente.

Dettagli
https://developer-api.nest.com/structures/ structure_id /name
ritorna string
Esempi: "My Home", "Beach House", "Mountain House"
Accesso leggere scrivere
Disponibile in Leggere:
Lettura termostato / v1-v6
Termostato lettura / scrittura / v1-v6
Fumo + CO letto / v1-v5
Lettura fuori casa / v1-v2
Lettura / scrittura assente / v1-v2
Scrittura ETA / v1-v2
Codice postale letto / v2
Lettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Fotocamera lettura / scrittura / v1-v3
Fotocamera lettura / scrittura + immagini / v1-v4
Energia letta / v2
Struttura lettura / scrittura / v1
Scrivi:
Struttura lettura / scrittura / v1

prefisso internazionale

Codice paese, in formato ISO 3166 alpha-2 .

Dettagli
https://developer-api.nest.com/structures/ structure_id /country_code
ritorna string
Esempi: "US", "CA", "UK"
Accesso sola lettura
Disponibile in Lettura termostato / v1-v6
Termostato lettura / scrittura / v1-v6
Fumo + CO letto / v1-v5
Lettura fuori casa / v1-v2
Lettura / scrittura assente / v1-v2
Scrittura ETA / v1-v2

codice postale

Codice postale o CAP, a seconda del paese.

Dettagli
https://developer-api.nest.com/structures/ structure_id /postal_code
ritorna string
Esempi: "94304", "94304-1027", "EC1A 1BB"
Accesso sola lettura
Disponibile in Codice postale letto / v1-v2

peak_period_start_time

Ora di inizio dell'evento dell'ora di punta dell'energia , in formato ISO 8601 .

Dettagli
https://developer-api.nest.com/structures/ structure_id /peak_period_start_time
ritorna string
Esempio: "2016-12-31T23: 59: 59.000Z"
Accesso sola lettura
Disponibile in Lettura termostato / v1-v6
Termostato lettura / scrittura / v1-v6
Energia letta / v1-v2

peak_period_end_time

Ora di fine dell'evento dell'ora di punta dell'energia , in formato ISO 8601 .

Dettagli
https://developer-api.nest.com/structures/ structure_id /peak_period_end_time
ritorna string
Esempio: "2016-12-31T23: 59: 59.000Z"
Accesso sola lettura
Disponibile in Lettura termostato / v1-v6
Termostato lettura / scrittura / v1-v6
Energia letta / v1-v2

fuso orario

Fuso orario presso la struttura, nel formato fuso orario IANA .

Dettagli
https://developer-api.nest.com/structures/ structure_id /time_zone
ritorna string
Esempio: "America / Los_Angeles"
Accesso sola lettura
Disponibile in Lettura termostato / v1-v6
Termostato lettura / scrittura / v1-v6
Fumo + CO letto / v1-v5
Lettura fuori casa / v1-v2
Lettura / scrittura assente / v2
Scrittura ETA / v1-v2

eta

L'ETA (tempo stimato di arrivo) è un oggetto che può essere impostato su una struttura. Viene utilizzato per far sapere a Nest che un utente dovrebbe tornare a casa in un momento specifico. Per informazioni su come effettuare una chiamata ETA, vedere la Guida assente .

Dettagli
https://developer-api.nest.com/structures/ structure_id /eta
ritorna object
Esempio: "myTripID1024", "2014-10-31T22: 42: 00.000Z", "2016-12-31T23: 59: 59.000Z"
Parametri
trip_id Una stringa definita dall'utente che identifica il viaggio
estimated_arrival_window_begin Un timestamp in formato ISO 8601 .
Deve essere maggiore di NOW .
estimated_arrival_window_end Un timestamp in formato ISO 8601 .
Deve essere maggiore di estimated_arrival_window_begin .
Accesso sola scrittura
Disponibile in Scrittura ETA / v1-v2

eta_begin

Timestamp della prima ora di arrivo prevista in formato ISO 8601 . Utilizzato per attivare azioni o eventi.

Dettagli
https://developer-api.nest.com/structures/ structure_id /eta_begin
ritorna string
Esempio: "2016-12-31T23: 59: 59.000Z"
Accesso sola lettura
Disponibile in ETA letto / v1

rhr_enrollment

Stato di iscrizione a Premi ore di punta .

Dettagli
https://developer-api.nest.com/structures/ structure_id /rhr_enrollment
ritorna boolean
Valori: vero, falso
Accesso sola lettura
Disponibile in Energia letta / v1-v2

wwn_security_state

Stato di sicurezza della struttura.

Dettagli
https://developer-api.nest.com/structures/ structure_id /wwn_security_state
genere string enum
Valori: "ok", "scoraggia"
Accesso sola lettura
Disponibile in Stato di sicurezza letto / v1

dov 'è

Un oggetto contenente gli identificatori where_id ( where_id e name ) per i dispositivi nella struttura. name è il nome visualizzato del dispositivo. Può essere il nome di una stanza qualsiasi da un elenco fornito o un nome personalizzato.

Per ulteriori informazioni su wheres , vedere la struttura di guida .

Scopri di più sui nomi di termostatiNest ,Nest Protect e Nest Cam .

Dettagli
https://developer-api.nest.com/structures/ structure_id /wheres
ritorna object
Accesso sola lettura
Disponibile in Leggere:
Lettura termostato / v3-v6
Termostato lettura / scrittura / v3-v6
Fumo + CO letto / v3-v5
Lettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Fotocamera lettura / scrittura / v1-v3
Fotocamera lettura / scrittura + immagini / v1-v4

dove_id

Un identificatore univoco generato da Nest che rappresenta il name .

where_id viene creato automaticamente e restituito durante la chiamata per creare il name .

Dettagli
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /where_id
ritorna string
Esempio: "Fqp6wJI ..."
Accesso sola lettura
Disponibile in Leggere:
Lettura termostato / v3-v6
Termostato lettura / scrittura / v3-v6
Fumo + CO letto / v3-v5
Lettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Fotocamera lettura / scrittura / v1-v3
Fotocamera lettura / scrittura + immagini / v1-v4

nome

Il nome visualizzato del dispositivo.

Dettagli
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /name
ritorna string
Esempio: "Camera da letto"
Accesso leggere scrivere
Disponibile in Leggere:
Lettura termostato / v3-v6
Termostato lettura / scrittura / v3-v6
Fumo + CO letto / v3-v5
Lettura fotocamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Fotocamera lettura / scrittura / v1-v3
Fotocamera lettura / scrittura + immagini / v1-v4

co_alarm_state

Stato di allarme CO.

Dettagli
https://developer-api.nest.com/structures/ structure_id /co_alarm_state
ritorna string enum
Valori: "ok", "warning", "emergency"
Accesso sola lettura
Disponibile in Fumo + CO letto / v5

smoke_alarm_state

Stato di allarme fumo.

Dettagli
https://developer-api.nest.com/structures/ structure_id /smoke_alarm_state
ritorna string enum
Valori: "ok", "warning", "emergency"
Accesso sola lettura
Disponibile in Fumo + CO letto / v5