API de cámara

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

Los usuarios pueden añadir varios Nest levas a la devices/cameras grupo, hasta el máximo por la estructura . Cuando realiza una llamada a esta ubicación de datos, puede acceder a los datos de Nest Cam (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

Identificador único de Nest Cam.

Detalles
https://developer-api.nest.com/devices/cameras/ device_id /device_id
Devoluciones	string Ejemplo: "awJo6rH ..."
Acceso	solo lectura
Disponible en	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

structure_id

Identificador único de estructura.

Detalles
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
Devoluciones	string Ejemplo: "VqFabWH21nw ..."
Acceso	solo lectura
Disponible en	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

where_name

El nombre para mostrar del dispositivo. Asociado a la Nest Cam where_id . Puede ser cualquier nombre de habitación 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	Lectura de cámara / v3 Cámara + lectura + imágenes / v4 Lectura / escritura de cámara / v3 Lectura / escritura de cámara + imágenes / v4

nombre

Nombre para mostrar del dispositivo; puede ser cualquier nombre de habitación 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

name_long

Nombre de visualización 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

está en linea

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

Detalles
https://developer-api.nest.com/devices/cameras/ device_id /is_online
Devoluciones	boolean Valores: verdadero, falso
Acceso	solo lectura
Disponible en	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

is_streaming

Estado de la cámara, ya sea encendida y transmitiendo video activamente, o apagada. 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

is_audio_input_enabled

Estado del micrófono de la cámara, ya sea encendido, escuchando o apagado. 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

web_url

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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

app_url

URL de la aplicación (enlace profundo) a la transmisión de video en vivo 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / 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 + lectura + imágenes / v3-v4 Lectura / escritura + imágenes de la cámara / v3-v4

activity_zones

Devuelve una matriz de todas las Zonas de actividad definidas.

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 + lectura + imágenes / v3-v4 Lectura / escritura + imágenes de la cámara / 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 + lectura + imágenes / v3-v4 Lectura / escritura + imágenes de la cámara / v3-v4

snapshot_url

Capture una imagen a pedido. Devuelve la URL de una imagen capturada de la transmisión de video en vivo. Requiere que la cámara esté encendida y transmitiendo activamente.

Utilice este campo para obtener una instantánea de la transmisión de video en vivo.

• 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 transmitiendo activamente

La calidad de la instantánea de la API es de solo 1080p si:

• 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 transmisión o no tiene una suscripción a Nest Aware, la API no tiene una fuente de 1080p desde la cual recuperar una instantánea con esa resolución y genera una imagen de menor calidad. Además, un ancho de banda de red local bajo puede hacer que la resolución de la instantánea de la API caiga por debajo de 1080p con Nest Aware presente.

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 + lectura + imágenes / v3-v4 Lectura / escritura + imágenes de la cámara / v3-v4

último evento

Este objeto captura información sobre el último evento que provocó 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

Evento de sonido: se detectó 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

has_motion

Evento de movimiento: se detectó 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

has_person

Evento de 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

web_url

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

Requiere Nest Aware . Si la URL del evento ha caducado o el dispositivo no tiene una suscripción activa, este valor no se incluye 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

app_url

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

Requiere Nest Aware . Si la URL del evento ha caducado o el dispositivo no tiene una suscripción activa, este valor no se incluye 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	Lectura de cámara / v1-v3 Cámara + lectura + imágenes / v1-v4 Lectura / escritura de cámara / v1-v3 Lectura / escritura + imágenes de la cámara / v1-v4

URL de la imagen

URL (enlace) al archivo de imagen capturado 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 + lectura + imágenes / v1-v4 Lectura / escritura + imágenes de la cámara / v1-v4

url_imagen_animada

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 + lectura + imágenes / v1-v4 Lectura / escritura + imágenes de la cámara / v1-v4

activity_zone_ids

Identificadores para zonas de actividad que detectaron 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 + lectura + imágenes / v3-v4 Lectura / escritura + imágenes de la cámara / v3-v4