Google si impegna a promuovere l'equità razziale per le comunità nere. Vedi come.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

API struttura

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

Tutti i valori seguenti sono disponibili in ciascuna structures/ structure_id nel documento JSON.

structure_id

Numero identificativo della struttura. Quando si effettua una chiamata a questa posizione dei 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 Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6
Fumo + CO read / v1-v5
Lettura via / v1-v2
Via lettura / scrittura / v1-v2
ETA write / v1-v2
Codice postale letto / v2
Lettura telecamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Camera read / write / v1-v3
Lettura / scrittura + immagini / v1-v4 della fotocamera
Energia letta / v2

termostati

Elenco di termostati nella struttura, per identificativo univoco del dispositivo. Questa è una matrice 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 Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6
Fumo + CO read / v1-v5
Lettura via / v1-v2
Via lettura / scrittura / v1-v2
ETA write / v1-v2
Camera read / v2-v3
Lettura fotocamera + immagini / v2-v4
Camera read / write / v2-v3
Lettura / scrittura + immagini / v2-v4 della fotocamera

smoke_co_alarms

Elenco degli allarmi fumo + CO nella struttura, per identificativo univoco del dispositivo. Questa è una matrice 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 Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6
Fumo + CO read / v1-v5
Lettura via / v1-v2
Via lettura / scrittura / v1-v2
ETA write / v1-v2
Camera read / v2-v3
Lettura fotocamera + immagini / v2-v4
Camera read / write / v2-v3
Lettura / scrittura + immagini / v2-v4 della fotocamera

macchine fotografiche

Elenco di telecamere nella struttura, per identificativo univoco del dispositivo. Questa è una matrice 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 Termostato letto / v4-v6
Termostato di lettura / scrittura / v4-v6
Fumo + CO read / v4-v5
Lettura via / v2
Via lettura / scrittura / v2
ETA write / v2
Lettura telecamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Camera read / write / v1-v3
Lettura / scrittura + immagini / v1-v4 della fotocamera

lontano

Indica lo stato di occupazione della struttura.

Le strutture hanno due stati legati alla presenza: home o away home . 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: "casa", "via"
Accesso leggere scrivere
Disponibile in Leggere:
Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6
Fumo + CO read / v1-v5
Lettura via / v1-v2
Via lettura / scrittura / v1-v2
ETA write / v1-v2
Scrivi:
Via lettura / scrittura / v1-v2

nome

Nome visualizzato definito dall'utente della struttura.

Dettagli
https://developer-api.nest.com/structures/ structure_id /name
ritorna string
Esempi: "La mia casa", "Beach House", "Mountain House"
Accesso leggere scrivere
Disponibile in Leggere:
Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6
Fumo + CO read / v1-v5
Lettura via / v1-v2
Via lettura / scrittura / v1-v2
ETA write / v1-v2
Codice postale letto / v2
Lettura telecamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Camera read / write / v1-v3
Lettura / scrittura + immagini / v1-v4 della fotocamera
Energia letta / v2
Struttura lettura / scrittura / v1
Scrivi:
Struttura lettura / scrittura / v1

prefisso internazionale

Codice paese, nel formato ISO 3166 alfa-2 .

Dettagli
https://developer-api.nest.com/structures/ structure_id /country_code
ritorna string
Esempi: "US", "CA", "UK"
Accesso sola lettura
Disponibile in Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6
Fumo + CO read / v1-v5
Lettura via / v1-v2
Via lettura / scrittura / v1-v2
ETA write / 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 , nel 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 Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6
Energia letta / v1-v2

peak_period_end_time

Ora di fine dell'evento dell'ora di punta dell'energia , nel 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 Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6
Energia letta / v1-v2

fuso orario

Fuso orario nella struttura, nel formato di 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 Termostato letto / v1-v6
Termostato di lettura / scrittura / v1-v6
Fumo + CO read / v1-v5
Lettura via / v1-v2
Via lettura / scrittura / v2
ETA write / v1-v2

eta

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

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 di sola scrittura
Disponibile in ETA write / v1-v2

eta_begin

Data / ora del primo orario di arrivo previsto 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 read / v1

rhr_enrollment

Stato iscrizione Rush Hour Rewards .

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", "scoraggiare"
Accesso sola lettura
Disponibile in Stato di sicurezza letto / v1

dov 'è

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

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

Scopri di più sui nomi dei termostati Nest , Nest Protects e Nest Cams .

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

where_id

Un identificatore univoco, generato da Nest, che rappresenta il name .

where_id viene creato e restituito automaticamente 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:
Termostato letto / v3-v6
Termostato di lettura / scrittura / v3-v6
Fumo + CO read / v3-v5
Lettura telecamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Camera read / write / v1-v3
Lettura / scrittura + immagini / v1-v4 della fotocamera

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:
Termostato letto / v3-v6
Termostato di lettura / scrittura / v3-v6
Fumo + CO read / v3-v5
Lettura telecamera / v1-v3
Lettura fotocamera + immagini / v1-v4
Camera read / write / v1-v3
Lettura / scrittura + immagini / v1-v4 della fotocamera

co_alarm_state

Stato di allarme CO.

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

smoke_alarm_state

Stato dell'allarme fumo.

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