Notice: We're retiring Works with Nest. See the home page for more information.
En Google, luchamos por la equidad racial de la comunidad negra. Más información
Esta página se ha traducido con Cloud Translation API.
Switch to English

estructura API

Los usuarios pueden añadir un máximo de tres estructuras , con múltiples dispositivos por estructura.

Todo el debajo de los valores se encuentran bajo cada uno structures/ structure_id en el documento JSON.

structure_id

número de identificación de la estructura. Cuando se realiza una llamada a esta ubicación de los datos, puede acceder a los valores de los datos en esta estructura.

detalles
https://developer-api.nest.com/structures/ structure_id /structure_id
Devoluciones string
Ejemplo: "VqFabWH21nw ..."
Acceso solo lectura
Disponible en Termostato de lectura / V1-V6
Termostato de lectura / escritura / V1-V6
Humo + CO lectura / V1-V5
Distancia de lectura / V1-V2
Distancia de lectura / escritura / V1-V2
ETA escritura / V1-V2
Código postal de lectura / v2
Cámara de lectura / V1-V3
Cámara leer + images / V1-V4
Cámara de lectura / escritura / V1-V3
Cámara de lectura / escritura + images / V1-V4
Energía de lectura / v2

termostatos

Lista de los termostatos en la estructura, por identificador de dispositivo único. Esta es una matriz de objetos JSON que incluye todos los termostatos en la estructura.

detalles
https://developer-api.nest.com/structures/ structure_id /thermostats
Devoluciones array
Ejemplo: [ "peyiJNo0IldT2YlIVtYaGQ",... ]
Acceso solo lectura
Disponible en Termostato de lectura / V1-V6
Termostato de lectura / escritura / V1-V6
Humo + CO lectura / V1-V5
Distancia de lectura / V1-V2
Distancia de lectura / escritura / V1-V2
ETA escritura / V1-V2
Cámara de lectura / V2-V3
Cámara leer + images / V2-V4
Cámara de lectura / escritura / V2-V3
Cámara de lectura / escritura + images / V2-V4

smoke_co_alarms

Lista de humo + alarmas de CO en la estructura, por identificador de dispositivo único. Esta es una matriz de objetos JSON que incluye todos los detectores de humo + CO en la estructura.

detalles
https://developer-api.nest.com/structures/ structure_id /smoke_co_alarms
Devoluciones array
Ejemplo: [ "RTMTKxsQTCxzVcsySOHPxKoF4OyCifrs",... ]
Acceso solo lectura
Disponible en Termostato de lectura / V1-V6
Termostato de lectura / escritura / V1-V6
Humo + CO lectura / V1-V5
Distancia de lectura / V1-V2
Distancia de lectura / escritura / V1-V2
ETA escritura / V1-V2
Cámara de lectura / V2-V3
Cámara leer + images / V2-V4
Cámara de lectura / escritura / V2-V3
Cámara de lectura / escritura + images / V2-V4

cámaras

Lista de cámaras en la estructura, por identificador de dispositivo único. Esta es una matriz de objetos JSON que incluye todas las cámaras en la estructura.

detalles
https://developer-api.nest.com/structures/ structure_id /cameras
Devoluciones array
Ejemplo: [ "awJo6rH...",... ]
Acceso solo lectura
Disponible en Termostato de lectura / V4-V6
Termostato de lectura / escritura / V4-V6
Humo + CO lectura / v4-v5
Distancia de lectura / v2
Distancia de lectura / escritura / v2
ETA escritura / v2
Cámara de lectura / V1-V3
Cámara leer + images / V1-V4
Cámara de lectura / escritura / V1-V3
Cámara de lectura / escritura + images / V1-V4

lejos

Indica el estado de ocupación de la estructura.

Estructuras tienen dos estados relacionados con la presencia: home o la away . Cuando hay movimiento es detectado en la casa, la estructura cambiará de home a away .

detalles
https://developer-api.nest.com/structures/ structure_id /away
Devoluciones string
Valores: "casa", "distancia"
Acceso leer escribir
Disponible en Leer:
Termostato de lectura / V1-V6
Termostato de lectura / escritura / V1-V6
Humo + CO lectura / V1-V5
Distancia de lectura / V1-V2
Distancia de lectura / escritura / V1-V2
ETA escritura / V1-V2
Escribir:
Distancia de lectura / escritura / V1-V2

nombre

definido por el usuario nombre de visualización de la estructura.

detalles
https://developer-api.nest.com/structures/ structure_id /name
Devoluciones string
Ejemplos: "Mi casa", "casa de playa", "Casa de la montaña"
Acceso leer escribir
Disponible en Leer:
Termostato de lectura / V1-V6
Termostato de lectura / escritura / V1-V6
Humo + CO lectura / V1-V5
Distancia de lectura / V1-V2
Distancia de lectura / escritura / V1-V2
ETA escritura / V1-V2
Código postal de lectura / v2
Cámara de lectura / V1-V3
Cámara leer + images / V1-V4
Cámara de lectura / escritura / V1-V3
Cámara de lectura / escritura + images / V1-V4
Energía de lectura / v2
Estructura de lectura / escritura / v1
Escribir:
Estructura de lectura / escritura / v1

código de país

Código del país, en la norma ISO 3166 alfa-2 formato.

detalles
https://developer-api.nest.com/structures/ structure_id /country_code
Devoluciones string
Ejemplos: "nos", "CA", "Reino Unido"
Acceso solo lectura
Disponible en Termostato de lectura / V1-V6
Termostato de lectura / escritura / V1-V6
Humo + CO lectura / V1-V5
Distancia de lectura / V1-V2
Distancia de lectura / escritura / V1-V2
ETA escritura / V1-V2

código postal

Postal o código postal, dependiendo del país.

detalles
https://developer-api.nest.com/structures/ structure_id /postal_code
Devoluciones string
Ejemplos: "94304", "94304 hasta 1027", "EC1A 1BB"
Acceso solo lectura
Disponible en Código Postal de lectura / V1-V2

peak_period_start_time

Hora de inicio de la hora punta de la energía caso, en la norma ISO 8601 de formato.

detalles
https://developer-api.nest.com/structures/ structure_id /peak_period_start_time
Devoluciones string
Ejemplo: "2016-12-31T23: 59: 59.000Z"
Acceso solo lectura
Disponible en Termostato de lectura / V1-V6
Termostato de lectura / escritura / V1-V6
Energía de lectura / V1-V2

peak_period_end_time

Hora de finalización de la hora punta de la energía caso, en la norma ISO 8601 de formato.

detalles
https://developer-api.nest.com/structures/ structure_id /peak_period_end_time
Devoluciones string
Ejemplo: "2016-12-31T23: 59: 59.000Z"
Acceso solo lectura
Disponible en Termostato de lectura / V1-V6
Termostato de lectura / escritura / V1-V6
Energía de lectura / V1-V2

zona horaria

Zona horaria en la estructura, en la zona horaria IANA formato.

detalles
https://developer-api.nest.com/structures/ structure_id /time_zone
Devoluciones string
Ejemplo: "América / Los_Angeles"
Acceso solo lectura
Disponible en Termostato de lectura / V1-V6
Termostato de lectura / escritura / V1-V6
Humo + CO lectura / V1-V5
Distancia de lectura / V1-V2
Distancia de lectura / escritura / v2
ETA escritura / V1-V2

eta

ETA (hora estimada de llegada) es un objeto que se puede configurar en una estructura. Se utiliza para dar a conocer el nido que se espera que un usuario de volver a casa a una hora determinada. Para obtener información sobre cómo realizar una llamada de ETA, ver el Away Guías .

detalles
https://developer-api.nest.com/structures/ structure_id /eta
Devoluciones object
Ejemplo: "myTripID1024", "2014-10-31T22: 42: 00.000Z", "2016-12-31T23: 59: 59.000Z"
parámetros
trip_id Una cadena definida por el usuario que identifica al viaje
estimated_arrival_window_begin Una marca de tiempo en la norma ISO 8601 de formato.
Debe ser mayor que NOW .
estimated_arrival_window_end Una marca de tiempo en la norma ISO 8601 de formato.
Debe ser mayor que estimated_arrival_window_begin .
Acceso escribir solamente
Disponible en ETA escritura / V1-V2

eta_begin

Marca de tiempo de la hora más temprana prevista de llegada con la norma ISO 8601 de formato. Se utiliza para acciones o eventos de activación.

detalles
https://developer-api.nest.com/structures/ structure_id /eta_begin
Devoluciones string
Ejemplo: "2016-12-31T23: 59: 59.000Z"
Acceso solo lectura
Disponible en ETA lectura / v1

rhr_enrollment

Hora punta Rewards estado de inscripción.

detalles
https://developer-api.nest.com/structures/ structure_id /rhr_enrollment
Devoluciones boolean
Valores: verdadero, falso
Acceso solo lectura
Disponible en Energía de lectura / V1-V2

wwn_security_state

Estado de seguridad estructura.

detalles
https://developer-api.nest.com/structures/ structure_id /wwn_security_state
Tipo string enum
Valores: "ok", "disuadir"
Acceso solo lectura
Disponible en Estado de seguridad de lectura / v1

wheres

Un objeto que contiene donde identificadores ( where_id y name ) para los dispositivos en la estructura. name es el nombre de visualización del dispositivo. Puede ser cualquier nombre de la sala de una lista que proporcionamos, o un nombre personalizado.

Para obtener más información sobre wheres , ver la estructura de guía .

Más información sobre dónde nombres para termostatos Nest , Nido Protege y Nido de levas .

detalles
https://developer-api.nest.com/structures/ structure_id /wheres
Devoluciones object
Acceso solo lectura
Disponible en Leer:
Termostato de lectura / V3-V6
Termostato de lectura / escritura / V3-V6
Humo + CO lectura / v3-v5
Cámara de lectura / V1-V3
Cámara leer + images / V1-V4
Cámara de lectura / escritura / V1-V3
Cámara de lectura / escritura + images / V1-V4

where_id

Un identificador único, generado Nest-que representa name .

where_id se crea y devuelto durante la llamada para crear automáticamente name .

detalles
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /where_id
Devoluciones string
Ejemplo: "Fqp6wJI ..."
Acceso solo lectura
Disponible en Leer:
Termostato de lectura / V3-V6
Termostato de lectura / escritura / V3-V6
Humo + CO lectura / v3-v5
Cámara de lectura / V1-V3
Cámara leer + images / V1-V4
Cámara de lectura / escritura / V1-V3
Cámara de lectura / escritura + images / V1-V4

nombre

El nombre de visualización del dispositivo.

detalles
https://developer-api.nest.com/structures/ structure_id /wheres/ where_id /name
Devoluciones string
Ejemplo: "El dormitorio"
Acceso leer escribir
Disponible en Leer:
Termostato de lectura / V3-V6
Termostato de lectura / escritura / V3-V6
Humo + CO lectura / v3-v5
Cámara de lectura / V1-V3
Cámara leer + images / V1-V4
Cámara de lectura / escritura / V1-V3
Cámara de lectura / escritura + images / V1-V4

co_alarm_state

estado de la alarma de CO.

detalles
https://developer-api.nest.com/structures/ structure_id /co_alarm_state
Devoluciones string enum
Valores: "ok", "aviso", "emergencia"
Acceso solo lectura
Disponible en Humo + CO lectura / v5

smoke_alarm_state

El humo estado de alarma.

detalles
https://developer-api.nest.com/structures/ structure_id /smoke_alarm_state
Devoluciones string enum
Valores: "ok", "aviso", "emergencia"
Acceso solo lectura
Disponible en Humo + CO lectura / v5