API de la cámara

La API Nido funciona con todos los modelos Nest Cam ™.

Los usuarios pueden añadir varios Nest levas a la devices/cameras grupo, hasta el máximo por la estructura . Cuando se realiza una llamada a esta ubicación de los datos, se puede acceder a los datos Nido de ajuste (valores de datos para dispositivos en la estructura).

Todo el debajo de los valores se encuentran en cada una de devices/cameras/ device_id en el documento JSON.

ID del dispositivo

Nest Cam identificador único.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /device_id
Devoluciones	string Ejemplo: "awJo6rH ..."
Acceso	solo lectura
Disponible en	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

Versión del software

Versión del software.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /software_version
Devoluciones	string Ejemplo: "4,0"
Acceso	solo lectura
Disponible en	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

structure_id

Estructurar identificador único.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
Devoluciones	string Ejemplo: "VqFabWH21nw ..."
Acceso	solo lectura
Disponible en	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 , el nombre de visualización del dispositivo.

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

detalles
https://developer-api.nest.com/devices/cameras/ device_id /where_id
Devoluciones	string Ejemplo: "d6reb_OZTM ..."
Acceso	solo lectura
Disponible en	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_name

El nombre de visualización del dispositivo. Asociado a la Nest Cam where_id . Puede ser cualquier nombre de la sala de una lista que proporcionamos, o un nombre personalizado. Más información sobre dónde nombres para termostatos Nest , Nido Protege y Nido de levas .

detalles
https://developer-api.nest.com/devices/cameras/ device_id /where_name
Devoluciones	string Ejemplo: "Pasillo"
Acceso	solo lectura
Disponible en	Cámara de lectura / v3 Cámara leer + images / v4 Cámara de lectura / escritura / v3 Cámara de lectura / escritura + images / v4

nombre

Visualización Nombre del dispositivo; puede ser cualquier nombre de la sala de una lista que proporcionamos, o un nombre personalizado.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /name
Devoluciones	string Ejemplo: "Pasillo"
Acceso	solo lectura
Disponible en	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

NAME_LONG

nombre para mostrar largo del dispositivo. Incluye una costumbre (etiqueta), creado por el usuario, o por medio de wheres .

detalles
https://developer-api.nest.com/devices/cameras/ device_id /name_long
Devoluciones	string Ejemplo: "Pasillo Nest Cam (arriba)"
Acceso	solo lectura
Disponible en	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

está en linea

el estado de conexión del dispositivo con el servicio de Nest.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /is_online
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	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

is_streaming

Estado de la cámara, ya sea en forma activa y streaming de vídeo, o apagado. Ver cómo su cámara funciona con Local / Visitante Assist para obtener más información.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
Devoluciones	boolean Valores: verdadero, falso
Acceso	leer escribir
Disponible en	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

is_audio_input_enabled

el estado del micrófono de la cámara, ya sea en la escucha y, dentro o fuera. Más información sobre la configuración de audio Nest Cam .

detalles
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	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

last_is_online_change

Marca de tiempo que identifica el último cambio en el estado de conexión, en la norma ISO 8601 de formato.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change
Devoluciones	string Ejemplo: "2016-12-29T18: 42: 00.000Z"
Acceso	solo lectura
Disponible en	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

is_video_history_enabled

Nest Aware estado de suscripción (suscripción activa o no).

detalles
https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	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

URL_web

Web URL (enlace profundo) para la transmisión de video en vivo en home.nest.com .

detalles
https://developer-api.nest.com/devices/cameras/ device_id /web_url
Devoluciones	string Ejemplo: " https://home.nest.com/cameras/ device_id ?auth= camera_token "
Acceso	solo lectura
Disponible en	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

APP_URL

Aplicación URL (enlace profundo) a la secuencia de vídeo en directo en la aplicación Nest.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /app_url
Devoluciones	string Ejemplo: " nestmobile://cameras/ device_id ?auth= camera_token "
Acceso	solo lectura
Disponible en	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

is_public_share_enabled

Los usuarios pueden optar por compartir su video y hacer que sea visible por cualquier persona. Cuando se habilita la participación pública, se puede leer public_share_url .

detalles
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Cámara leer + images / V3-V4 Cámara de lectura / escritura + images / V3-V4

activity_zones

Devuelve una matriz de todas las zonas de actividad definida.

Zonas de actividad se utilizan para controlar los eventos de movimiento dentro de las áreas definidas por el usuario de la secuencia de vídeo. Requiere Nest Aware .

detalles
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
Devoluciones	array Ejemplo: [ {"name" : " string1 ", "id" : " string2 "},... ] • string1 es el nombre de zona, ya sea generada o cuando se crea de forma automática la zona definida por el usuario. • string2 es un identificador asignado por el nido cuando se crea la zona de actividad.
Acceso	solo lectura
Disponible en	Cámara leer + images / V3-V4 Cámara de lectura / escritura + images / V3-V4

public_share_url

Puede acceder a esta URL cuando un usuario hace que su público secuencia de vídeo .

detalles
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
Devoluciones	string Ejemplo: " https://video.nest.com/live/ string1 ? string2 " string1 es el nombre de la secuencia de vídeo, ya sea o generados automáticamente cuando la corriente se establece en pública definida por el usuario.
Acceso	solo lectura
Disponible en	Cámara leer + images / V3-V4 Cámara de lectura / escritura + images / V3-V4

SNAPSHOT_URL

Capturar una imagen en la demanda. Devuelve la URL de una imagen capturada de la secuencia de vídeo en directo. Requiere que la cámara está encendida y el streaming de forma activa.

Utilice este campo para obtener una instantánea del flujo de vídeo en directo.

• snapshot_url - devuelve la URL de una imagen capturada de la secuencia de vídeo en directo
• Requiere que la cámara está encendida y el streaming de forma activa

La calidad de las instantáneas del API solo 1080p rendimiento si es:

• viendo activamente el flujo de la cámara en la aplicación ( web_url )
• viendo activamente el flujo de público ( app_url )
• suscrito a Nest Aware

Si no está viendo activamente la corriente o no tiene una suscripción Consciente Nido, la API no tiene 1080p fuente de la que se debe recuperar una instantánea en esa resolución y genera una imagen de calidad inferior. También, bajo ancho de banda de la red local puede causar la resolución API instantánea para descienden por debajo de 1080p con la jerarquía presente Consciente.

Más información sobre los requisitos de ancho de banda para Cámaras Nido .

Los límites de frecuencia se aplican a esta llamada, dependiendo de Nest Aware estado de suscripción .

detalles
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url
Devoluciones	string Ejemplo: " string1 / device_id / string2 ?auth= camera_token "
Acceso	solo lectura
Disponible en	Cámara leer + images / V3-V4 Cámara de lectura / escritura + images / V3-V4

último evento

Este objeto capta información sobre el último evento que desencadenó una notificación.

Algunos campos y algunas combinaciones de permisos requieren un Consciente Nido de suscripción para acceder a la última información del evento.

Todo el debajo de los valores se encuentran bajo cada uno de devices/cameras/ device_id /last_event en el documento JSON.

has_sound

Se detectó sonido - evento de sonido.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	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

has_motion

se detectó movimiento - evento de movimiento.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	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

has_person

acontecimiento persona - se detectó una persona.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	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

hora de inicio

Evento hora de inicio, en la norma ISO 8601 de formato.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time
Devoluciones	string Ejemplo: "2016-12-29T00: 00: 00.000Z"
Acceso	solo lectura
Disponible en	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

hora de finalización

Evento hora de finalización, en la norma ISO 8601 de formato.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time
Devoluciones	string Ejemplo: "2016-12-29T00: 00: 00.000Z"
Acceso	solo lectura
Disponible en	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

urls_expire_time

Marca de tiempo, en la norma ISO 8601 de formato, que identifica la expiración de estas URL relacionados con eventos:

• last_event/web_url
• last_event/app_url
• last_event/image_url
• last_event/animated_image_url

Tiempo de expiración se calcula como: last_event/start_time + n días (donde n = 10 o 30 días, dependiendo de la Aware Nest plan de suscripción ).

Requiere Nest Aware .

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time
Devoluciones	string Ejemplo: "2016-12-29T00: 00: 00.000Z"
Acceso	solo lectura
Disponible en	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

URL_web

Web URL (enlace profundo) con el último sonido o evento de movimiento en home.nest.com . Se utiliza para visualizar el último evento registrado, y requiere que el usuario iniciar sesión en la cuenta.

Requiere Nest Aware . Si la URL del evento ha expirado o el dispositivo no tiene una suscripción activa, entonces este valor no está incluido en la carga útil.

Ver last_event/urls_expire_time para obtener información sobre el tiempo de caducidad de esta URL.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url
Devoluciones	string Ejemplo: " https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token "
Acceso	solo lectura
Disponible en	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

APP_URL

URL aplicación de Nest (enlace profundo) con el último sonido o evento de movimiento. Se utiliza para visualizar el último evento registrado, y requiere que el usuario iniciar sesión en la cuenta.

Requiere Nest Aware . Si la URL del evento ha expirado o el dispositivo no tiene una suscripción activa, entonces este valor no está incluido en la carga útil.

Ver last_event/urls_expire_time para obtener información sobre el tiempo de caducidad de esta URL.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url
Devoluciones	string Ejemplo: " nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token "
Acceso	solo lectura
Disponible en	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

URL de la imagen

URL (enlace) en el fichero de imagen capturada para un evento de sonido o movimiento.

Requiere Nest Aware . Ver last_event/urls_expire_time para obtener información sobre el tiempo de caducidad de esta URL.

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url
Devoluciones	string Ejemplo: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Acceso	solo lectura
Disponible en	Cámara leer + images / V1-V4 Cámara de lectura / escritura + images / V1-V4

animated_image_url

URL (enlace) al archivo gif capturado para un evento de sonido o movimiento.

Requiere Nest Aware .

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url
Devoluciones	string Ejemplo: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Acceso	solo lectura
Disponible en	Cámara leer + images / V1-V4 Cámara de lectura / escritura + images / V1-V4

activity_zone_ids

Identificadores de Zonas de Actividades que se detecta un evento de movimiento.

Requiere Nest Aware . Cuando se utiliza con el activity_zones matriz, se puede obtener el nombre de zona de estos identificadores.

Si last_event/has_motion es

• true = devuelve los ID de zona de actividad que detecta un evento de movimiento
• false = devuelve una matriz vacía

detalles
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
Devoluciones	array Ejemplo: [ string1 , string2 ,... ]
Acceso	solo lectura
Disponible en	Cámara leer + images / V3-V4 Cámara de lectura / escritura + images / V3-V4