L'API Nest funziona con tutti i modelli Nest Cam ™.
Gli utenti possono aggiungere più Nest Cam al gruppo devices/cameras , fino al massimo per struttura . Quando si effettua una chiamata a questa posizione dei dati, è possibile accedere ai dati Nest Cam (valori dei dati per i dispositivi nella struttura).
Tutti i valori seguenti si trovano sotto ciascun devices/cameras/ device_id nel documento JSON.
ID del dispositivo
Identificatore univoco Nest Cam.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /device_id | |
| ritorna | string Esempio: "awJo6rH ..." |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
versione software
Versione software.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /software_version | |
| ritorna | string Esempio: "4.0" |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
structure_id
Identificatore univoco della struttura.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /structure_id | |
| ritorna | string Esempio: "VqFabWH21nw ..." |
| Accesso | sola lettura |
| Disponibile in | 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 , il nome visualizzato del dispositivo.
Scopri di più sui nomi dei termostati Nest , Nest Protects e Nest Cams .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /where_id | |
| ritorna | string Esempio: "d6reb_OZTM ..." |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
where_name
Il nome visualizzato del dispositivo. Associato alla Nest Cam where_id . Può essere qualsiasi nome di stanza da un elenco che forniamo o un nome personalizzato. Scopri di più sui nomi dei termostati Nest , Nest Protects e Nest Cams .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /where_name | |
| ritorna | string Esempio: "Corridoio" |
| Accesso | sola lettura |
| Disponibile in | Camera read / v3 Lettura fotocamera + immagini / v4 Camera read / write / v3 Lettura / scrittura + immagini / v4 della fotocamera |
nome
Visualizza il nome del dispositivo; può essere qualsiasi nome di stanza da un elenco che forniamo o un nome personalizzato.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /name | |
| ritorna | string Esempio: "Corridoio" |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
NAME_LONG
Nome visualizzato lungo del dispositivo. Include un personalizzato (etichetta), creata dall'utente, o tramite wheres .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /name_long | |
| ritorna | string Esempio: "Hallway Nest Cam (sopra)" |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
è in linea
Stato della connessione del dispositivo con il servizio Nest.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /is_online | |
| ritorna | boolean Valori: vero, falso |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
is_streaming
Stato della videocamera, attiva e attiva lo streaming video o disattivata. Per ulteriori informazioni, vedere Come funziona la videocamera con l'assistenza in casa / fuori casa .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming | |
| ritorna | boolean Valori: vero, falso |
| Accesso | leggere scrivere |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
is_audio_input_enabled
Stato del microfono della fotocamera, acceso e in ascolto o spento. Ulteriori informazioni sulle impostazioni audio di Nest Cam .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled | |
| ritorna | boolean Valori: vero, falso |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
last_is_online_change
Timestamp che identifica l'ultima modifica allo stato online, nel formato ISO 8601 .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change | |
| ritorna | string Esempio: "29-12-2016T18: 42: 00.000Z" |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
is_video_history_enabled
Stato dell'abbonamento Nest Aware (abbonamento attivo o meno).
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled | |
| ritorna | boolean Valori: vero, falso |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
web_url
URL Web (collegamento diretto) allo streaming video live su home.nest.com .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /web_url | |
| ritorna | string Esempio: " https://home.nest.com/cameras/ device_id ?auth= camera_token " |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
APP_URL
URL dell'app (collegamento diretto) allo streaming video live nell'app Nest.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /app_url | |
| ritorna | string Esempio: " nestmobile://cameras/ device_id ?auth= camera_token " |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
is_public_share_enabled
Gli utenti possono scegliere di condividere i loro video e renderli visualizzabili da chiunque. Quando la condivisione pubblica è abilitata, puoi leggere public_share_url .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled | |
| ritorna | boolean Valori: vero, falso |
| Accesso | sola lettura |
| Disponibile in | Lettura fotocamera + immagini / v3-v4 Lettura / scrittura + immagini / v3-v4 della fotocamera |
activity_zones
Restituisce un array di tutte le zone di attività definite.
Le zone di attività vengono utilizzate per monitorare gli eventi di movimento all'interno di aree definite dall'utente dello streaming video. Richiede Nest Aware .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones | |
| ritorna | array Esempio: [ {"name" : " string1 ", "id" : " string2 "},... ] • string1 è il nome della zona, definita dall'utente o generata automaticamente al momento della creazione della zona. • string2 è un identificatore assegnato da Nest quando viene creata la Zona di attività. |
| Accesso | sola lettura |
| Disponibile in | Lettura fotocamera + immagini / v3-v4 Lettura / scrittura + immagini / v3-v4 della fotocamera |
public_share_url
Puoi accedere a questo URL quando un utente rende pubblico il suo flusso video .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url | |
| ritorna | string Esempio: " https://video.nest.com/live/ string1 ? string2 " string1 è il nome del flusso video, definito dall'utente o generato automaticamente quando il flusso è impostato su pubblico. |
| Accesso | sola lettura |
| Disponibile in | Lettura fotocamera + immagini / v3-v4 Lettura / scrittura + immagini / v3-v4 della fotocamera |
snapshot_url
Cattura un'immagine su richiesta. Restituisce l'URL di un'immagine acquisita dal flusso video live. Richiede che la fotocamera sia accesa e in streaming attivo.
Utilizzare questo campo per ottenere un'istantanea dal flusso video live.
-
snapshot_url: restituisce l'URL di un'immagine acquisita dal flusso video live - Richiede che la fotocamera sia accesa e in streaming attivo
La qualità dell'istantanea dall'API è solo 1080p throughput se si è:
- visualizzare attivamente il flusso della telecamera nell'applicazione (
web_url) - visualizzazione attiva dello stream pubblico (
app_url) - abbonato a Nest Aware
Se non stai visualizzando attivamente lo stream o non disponi di un abbonamento Nest Aware, l'API non ha una sorgente 1080p da cui recuperare un'istantanea a quella risoluzione e genera un'immagine di qualità inferiore. Inoltre, una bassa larghezza di banda della rete locale può far scendere la risoluzione dell'istantanea API al di sotto di 1080p con Nest Aware presente.
Ulteriori informazioni sui requisiti di larghezza di banda per le videocamere Nest .
I limiti di tariffa si applicano a questa chiamata, a seconda dello stato dell'abbonamento Nest Aware.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url | |
| ritorna | string Esempio: " string1 / device_id / string2 ?auth= camera_token " |
| Accesso | sola lettura |
| Disponibile in | Lettura fotocamera + immagini / v3-v4 Lettura / scrittura + immagini / v3-v4 della fotocamera |
last_event
Questo oggetto acquisisce informazioni sull'ultimo evento che ha attivato una notifica.
Alcuni campi e alcune combinazioni di autorizzazioni richiedono un abbonamento Nest Aware per accedere alle informazioni dell'ultimo evento.
Tutti i valori seguenti si trovano sotto ciascun devices/cameras/ device_id /last_event nel documento JSON.
has_sound
Evento audio: il suono è stato rilevato.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound | |
| ritorna | boolean Valori: vero, falso |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
has_motion
Evento movimento: movimento rilevato.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion | |
| ritorna | boolean Valori: vero, falso |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
has_person
Evento persona: è stata rilevata una persona.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person | |
| ritorna | boolean Valori: vero, falso |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
Ora di inizio
Ora di inizio dell'evento, nel formato ISO 8601 .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time | |
| ritorna | string Esempio: "2016-12-29T00: 00: 00.000Z" |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
Tempo scaduto
Ora di fine dell'evento, nel formato ISO 8601 .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time | |
| ritorna | string Esempio: "2016-12-29T00: 00: 00.000Z" |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
urls_expire_time
Data / ora, nel formato ISO 8601 , che identifica la scadenza di questi URL relativi agli eventi:
Il tempo di scadenza è calcolato come: last_event/start_time + n giorni (dove n = 10 o 30 giorni, a seconda del piano di abbonamento Nest Aware).
Richiede Nest Aware .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time | |
| ritorna | string Esempio: "2016-12-29T00: 00: 00.000Z" |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
web_url
URL Web (collegamento diretto ) all'ultimo suono o evento di movimento su home.nest.com . Utilizzato per visualizzare l'ultimo evento registrato e richiede che l'utente abbia effettuato l'accesso all'account.
Richiede Nest Aware . Se l'URL dell'evento è scaduto o il dispositivo non ha un abbonamento attivo, questo valore non è incluso nel payload.
Vedi last_event/urls_expire_time per informazioni sul tempo di scadenza di questo URL.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url | |
| ritorna | string Esempio: " https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token " |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
APP_URL
Nest dell'app URL (deep link) all'ultimo suono o evento di movimento. Utilizzato per visualizzare l'ultimo evento registrato e richiede che l'utente abbia effettuato l'accesso all'account.
Richiede Nest Aware . Se l'URL dell'evento è scaduto o il dispositivo non ha un abbonamento attivo, questo valore non è incluso nel payload.
Vedi last_event/urls_expire_time per informazioni sul tempo di scadenza di questo URL.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url | |
| ritorna | string Esempio: " nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token " |
| Accesso | sola lettura |
| Disponibile in | Lettura telecamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Camera read / write / v1-v3 Lettura / scrittura + immagini / v1-v4 della fotocamera |
URL dell'immagine
URL (collegamento) al file di immagine acquisito per un evento audio o di movimento.
Richiede Nest Aware . Vedi last_event/urls_expire_time per informazioni sul tempo di scadenza di questo URL.
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url | |
| ritorna | string Esempio: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token " |
| Accesso | sola lettura |
| Disponibile in | Lettura fotocamera + immagini / v1-v4 Lettura / scrittura + immagini / v1-v4 della fotocamera |
animated_image_url
URL (collegamento) al file gif acquisito per un evento audio o di movimento.
Richiede Nest Aware .
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url | |
| ritorna | string Esempio: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token " |
| Accesso | sola lettura |
| Disponibile in | Lettura fotocamera + immagini / v1-v4 Lettura / scrittura + immagini / v1-v4 della fotocamera |
activity_zone_ids
Identificatori per Zone di attività che hanno rilevato un evento di movimento.
Richiede Nest Aware . Se utilizzato con l'array activity_zones , è possibile ottenere il nome della zona da questi ID.
-
true= restituisce gli ID della zona di attività che hanno rilevato un evento di movimento -
false= restituisce un array vuoto
| Dettagli | |
|---|---|
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids | |
| ritorna | array Esempio: [ string1 , string2 ,... ] |
| Accesso | sola lettura |
| Disponibile in | Lettura fotocamera + immagini / v3-v4 Lettura / scrittura + immagini / v3-v4 della fotocamera |