API Structured

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

Tutti i valori seguenti sono riportati sotto ogni structures/structure_id nel documento JSON.

struttura_id

Numero ID della struttura. Quando effettui una chiamata a questa località dei dati, puoi accedere ai valori dei dati in questa struttura.

Dettagli
https://developer-api.nest.com/structures/structure_id/structure_id
Restituiscestring
Esempio: "VqFabWH21nw..."
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura del termostato/v1-v6
Lettura + scrittura/fumo/v1-v5
Lettura/uscita v1-v2
Lettura/scrittura in modalità Fuori/v1-v2
Lettura v1-v3/Lettura della versione v1/

Fotocamera v1/v3

termostati

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

Dettagli
https://developer-api.nest.com/structures/structure_id/thermostats
Restituiscearray
Esempio: [ "peyiJNo0IldT2YlIVtYaGQ",... ]
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura del termostato/v1-v6
Lettura + scrittura/fumo/v1-v5
Lettura/uscita v1-v2
Lettura/scrittura in modalità Fuori/v1-v2
Lettura/scrittura v2/v2/v2 della videocamera/v2-v2

rilevatori di fumo

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

Dettagli
https://developer-api.nest.com/structures/structure_id/smoke_co_alarms
Restituiscearray
Esempio: [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ]
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura del termostato/v1-v6
Lettura + scrittura/fumo/v1-v5
Lettura/uscita v1-v2
Lettura/scrittura in modalità Fuori/v1-v2
Lettura/scrittura v2/v2/v2 della videocamera/v2-v2

videocamere

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

Dettagli
https://developer-api.nest.com/structures/structure_id/cameras
Restituiscearray
Esempio: [ "awJo6rH...",... ]
Accessosola lettura
Disponibile inLettura del termostato / v4-v6
Lettura/scrittura del termostato / v4-v6
Lettura + fumo / CO / v4-v5
Lettura/scrittura in modalità v2
Lettura / scrittura in Fuori / v2
Scrittura in modalità ETA / v2
Lettura / scrittura in fotocamera/V1-v3
Lettura / scrittura in fotocamera/v1-v4/

lontano

Indica lo stato di occupazione della struttura.

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

Dettagli
https://developer-api.nest.com/structures/structure_id/away
Restituiscestring
Valori: "home"
Accessolettura/scrittura
Disponibile inLettura:
Lettura del termostato/v1-v6
Lettura/scrittura del termostato/v1-v6
Lettura/scrittura lettura fumo/v1-v2
Lettura scrittura/v1-v2
Lettura/scrittura v1-v2

name

Nome visualizzato della struttura definito dall'utente.

Dettagli
https://developer-api.nest.com/structures/structure_id/name
Restituiscestring
Esempi: "La mia casa", "Casa sulla spiaggia", "Casa di montagna".
Accessolettura/scrittura
Disponibile inLettura:
Thermostat read / v1-v6
Thermostat read/write / v1-v6
Lettura fumo/CO / v1-v5
Lettura Lettura / v1-v2
Lettura Lettura/Scrittura / v1-v2
Lettura Lettura / 2
2 2
2 < 2
2

country_code

Codice paese, in formato ISO 3166 alpha-2.

Dettagli
https://developer-api.nest.com/structures/structure_id/country_code
Restituiscestring
Esempi: "US", "CA", "Regno Unito"
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura del termostato/v1-v6
Lettura + scrittura/fumo/v1-v5
Lettura/uscita v1-v2
Lettura/scrittura Fuori/v1-v2
ETA/v1-v2

codice_postale

Codice postale, a seconda del paese.

Dettagli
https://developer-api.nest.com/structures/structure_id/postal_code
Restituiscestring
Esempi: "94304", "94304-1027", "EC1A 1BB"
Accessosola lettura
Disponibile inCodice postale letto / v1-v2

picco_periodo_inizio_periodo

Ora di inizio dell'evento ora di punta del consumo energetico, in formato ISO 8601.

Dettagli
https://developer-api.nest.com/structures/structure_id/peak_period_start_time
Restituiscestring
Esempio: "2016-12-31T23:59:59.000Z"
Accessosola lettura
Disponibile inLettura del termostato / v1-v6
Lettura/scrittura del termostato / v1-v6
Lettura dell'energia / v1-v2

picco_periodo_fine_periodo

Ora di fine dell'evento ora di punta del consumo energetico, in formato ISO 8601.

Dettagli
https://developer-api.nest.com/structures/structure_id/peak_period_end_time
Restituiscestring
Esempio: "2016-12-31T23:59:59.000Z"
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura del termostato/v1-v6
Lettura dell'energia/v1-v2

fuso orario

Fuso orario nella struttura, nel formato fuso orario IANA.

Dettagli
https://developer-api.nest.com/structures/structure_id/time_zone
Restituiscestring
Esempio: "America/Los_Angeles"
Accessosola lettura
Disponibile inLettura del termostato/v1-v6
Lettura/scrittura del termostato/v1-v6
Lettura + scrittura/fumo/v1-v5
Lettura/uscita v1-v2
Lettura/scrittura Fuori/v2
Scrittura ATE/v1-v2

arrivo stimato

L'orario di arrivo stimato è un oggetto che può essere impostato su una struttura. Viene utilizzato per comunicare a Nest che l'utente dovrebbe tornare a casa in un orario specifico. Per informazioni su come effettuare una chiamata Orario di arrivo stimato, consulta la Guida in modalità Fuori.

Dettagli
https://developer-api.nest.com/structures/structure_id/eta
Restituisceobject
Esempio: "myTripID1024", "2014-10-31T22:42:00.000Z", "2016-12-31T23:59:59.000Z"
Parametri
trip_idUna stringa definita dall'utente che identifica la corsa
estimated_arrival_window_begin Un timestamp in formato ISO 8601.
Deve essere maggiore di NOW.
estimated_arrival_window_endUn timestamp in formato ISO 8601.
Deve essere maggiore di estimated_arrival_window_begin.
Accessosola scrittura
Disponibile inOrario di arrivo stimato: scrittura / v1-v2

eta_begin

Timestamp del primo orario di arrivo previsto nel formato ISO 8601. Utilizzato per attivare azioni o eventi.

Dettagli
https://developer-api.nest.com/structures/structure_id/eta_begin
Restituiscestring
Esempio: "2016-12-31T23:59:59.000Z"
Accessosola lettura
Disponibile inOrario di arrivo stimato letto / v1

registrazione_rhr

Stato registrazione: Premi ore di punta.

Dettagli
https://developer-api.nest.com/structures/structure_id/rhr_enrollment
Restituisceboolean
Valori: vero, falso
Accessosola lettura
Disponibile inLettura energia / v1-v2

wwn_security_state [stato_della_sicurezza_ww]

Struttura dello stato di sicurezza.

Dettagli
https://developer-api.nest.com/structures/structure_id/wwn_security_state
Tipostring enum
Valori: "ok", "deter"
Accessosola lettura
Disponibile inStato della sicurezza: lettura / versione 1

dov'è

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

Per ulteriori informazioni su wheres, consulta la Guida alla struttura.

Scopri di più su dove si trovano i nomi di Nest Thermostat, Nest Protect e Nest Cam.

Dettagli
https://developer-api.nest.com/structures/structure_id/wheres
Restituisceobject
Accessosola lettura
Disponibile inLettura:
Lettura del termostato / v3-v6
Lettura/scrittura del termostato / v3-v6
Lettura del fumo + CO / v3-v5
Lettura della fotocamera / v1-v3
Lettura della fotocamera + immagini / v1-v4
Lettura/scrittura della fotocamera / v1/v3 / v3

dove_id

Un identificatore univoco generato da Nest che rappresenta name.

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

Dettagli
https://developer-api.nest.com/structures/structure_id/wheres/where_id/where_id
Restituiscestring
Esempio: "Fqp6wJI..."
Accessosola lettura
Disponibile inLettura:
Lettura del termostato/v3-v6
Lettura/scrittura del termostato/v3-v6
Lettura fumo/CO/v3-v5
Lettura/scrittura fotocamera/v1-v3
Lettura/scrittura fotocamera/v1-v4
Lettura/scrittura fotocamera/v1-v3
Lettura/scrittura fotocamera + immagini/v1

name

Il nome visualizzato del dispositivo.

Dettagli
https://developer-api.nest.com/structures/structure_id/wheres/where_id/name
Restituiscestring
Esempio: "camera da letto".
Accessolettura/scrittura
Disponibile inLettura:
Lettura del termostato/v3-v6
Lettura/scrittura del termostato/v3-v6
Lettura fumo/CO//v3-v5
Lettura/scrittura della fotocamera/v1-v3
Lettura della fotocamera + immagini/v1-v4
Lettura/scrittura della fotocamera/v1-v3/v3

stato_co_alarm

Stato dell'allarme CO.

Dettagli
https://developer-api.nest.com/structures/structure_id/co_alarm_state
Restituiscestring enum
Valori: "ok", "avviso", "emergenza"
Accessosola lettura
Disponibile inLettura fumo/CO/v5

fumo_stato_allarme

Stato del rilevatore di fumo.

Dettagli
https://developer-api.nest.com/structures/structure_id/smoke_alarm_state
Restituiscestring enum
Valori: "ok", "avviso", "emergenza"
Accessosola lettura
Disponibile inLettura fumo/CO/v5