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:
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 |