API della fotocamera

L'API Nest funziona con tutti i modelli di Nest Cam ™.

Gli utenti possono aggiungere più Nest Cam al gruppo di devices/cameras , fino al massimo per struttura . Quando effettui una chiamata a questa posizione dati, puoi accedere ai dati della Nest Cam (valori dei dati per i dispositivi nella struttura).

Tutti i valori seguenti si trovano sotto ogni devices/cameras/ device_id nel documento JSON.

ID del dispositivo

Identificatore univoco di Nest Cam.

Dettagli
`https://developer-api.nest.com/devices/cameras/ device_id /device_id`
ritorna	`string` Esempio: "awJo6rH ..."
Accesso	sola lettura
Disponibile in	Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

struttura_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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

dove_id

Un identificatore univoco generato da Nest che rappresenta il name , il nome visualizzato del dispositivo.

Scopri di più sui nomi di termostati Nest ,Nest Protect e Nest Cam .

Dettagli
`https://developer-api.nest.com/devices/cameras/ device_id /where_id`
ritorna	`string` Esempio: "d6reb_OZTM ..."
Accesso	sola lettura
Disponibile in	Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

dove_nome

Il nome visualizzato del dispositivo. Associato alla Nest Cam where_id . Può essere un nome di stanza qualsiasi da un elenco fornito da noi o un nome personalizzato. Scopri di più sui nomi di termostati Nest ,Nest Protect e Nest Cam .

Dettagli
`https://developer-api.nest.com/devices/cameras/ device_id /where_name`
ritorna	`string` Esempio: "Corridoio"
Accesso	sola lettura
Disponibile in	Lettura fotocamera / v3 Lettura fotocamera + immagini / v4 Fotocamera lettura / scrittura / v3 Fotocamera lettura / scrittura + immagini / v4

nome

Visualizza il nome del dispositivo; può essere qualsiasi nome di stanza da un elenco fornito 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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

name_long

Nome visualizzato lungo del dispositivo. Include una (etichetta) personalizzata, creata dall'utente o tramite wheres .

Dettagli
`https://developer-api.nest.com/devices/cameras/ device_id /name_long`
ritorna	`string` Esempio: "Nest Cam corridoio (piano di sopra)"
Accesso	sola lettura
Disponibile in	Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

è in linea

Stato di 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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

is_streaming

Stato della videocamera, attiva e in streaming video attivo o disattivata. Per ulteriori informazioni, vedi Come funziona la videocamera con A 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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

is_audio_input_enabled

Stato del microfono della fotocamera, acceso e in ascolto o spento. Ulteriori informazioni sulle impostazioni audio della 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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

last_is_online_change

Timestamp che identifica l'ultima modifica allo stato online, in formato ISO 8601 .

Dettagli
`https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change`
ritorna	`string` Esempio: "2016-12-29T18: 42: 00.000Z"
Accesso	sola lettura
Disponibile in	Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

web_url

URL Web (collegamento diretto) al flusso video in diretta 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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

app_url

URL dell'app (collegamento diretto) allo streaming video in diretta 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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

is_public_share_enabled

Gli utenti possono scegliere di condividere il proprio video e renderlo visualizzabile 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 Fotocamera lettura / scrittura + immagini / v3-v4

activity_zones

Restituisce un array di tutte le Zone attive definite.

Le Zone attive vengono utilizzate per monitorare gli eventi di movimento all'interno delle aree definite dall'utente del flusso 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, definito dall'utente o generato automaticamente al momento della creazione della zona. • `string2` è un identificatore assegnato da Nest quando viene creata la Zona attiva.
Accesso	sola lettura
Disponibile in	Lettura fotocamera + immagini / v3-v4 Fotocamera lettura / scrittura + immagini / v3-v4

public_share_url

Puoi accedere a questo URL quando un utente rende pubblico il proprio 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 lo streaming è impostato su pubblico. Attenzione: `string2` viene utilizzata per effettuare la chiamata API. Non modificare la stringa o la chiamata fallirà.
Accesso	sola lettura
Disponibile in	Lettura fotocamera + immagini / v3-v4 Fotocamera lettura / scrittura + immagini / v3-v4

snapshot_url

Cattura un'immagine su richiesta. Restituisce l'URL di un'immagine acquisita dal flusso video in diretta. Richiede che la videocamera sia accesa e in streaming attivo.

Usa questo campo per ottenere un'istantanea dal flusso video in diretta.

snapshot_url : restituisce l'URL di un'immagine catturata dal flusso video live
Richiede che la videocamera sia accesa e in streaming attivo

La qualità dello snapshot dall'API è solo di 1080p se sei:

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 streaming o non hai 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 larghezza di banda della rete locale ridotta può far sì che la risoluzione dell'istantanea dell'API scenda al di sotto di 1080p con Nest Aware presente.

Ulteriori informazioni sui requisiti di larghezza di banda per le videocamere Nest .

A questa chiamata si applicano limiti di velocità , 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` " Attenzione: `string1` e `string2` vengono utilizzate per effettuare la chiamata API. Non modificare nessuna delle stringhe o la chiamata fallirà.
Accesso	sola lettura
Disponibile in	Lettura fotocamera + immagini / v3-v4 Fotocamera lettura / scrittura + immagini / v3-v4

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 sull'ultimo evento.

Tutti i valori seguenti si trovano sotto ogni devices/cameras/ device_id /last_event nel documento JSON.

has_sound

Evento sonoro: è stato rilevato un suono.

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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

has_motion

Evento di movimento: è stato rilevato un movimento.

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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

Ora di inizio

Ora di inizio dell'evento, in 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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

Tempo scaduto

Ora di fine dell'evento, in 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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

urls_expire_time

Timestamp, in formato ISO 8601 , che identifica la scadenza di questi URL correlati agli eventi:

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

Il tempo di scadenza viene 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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

web_url

URL Web (collegamento diretto ) all'ultimo evento di suono o movimento su home.nest.com . Utilizzato per visualizzare l'ultimo evento registrato e richiede che l'utente acceda all'account.

Richiede Nest Aware . Se l'URL dell'evento è scaduto o il dispositivo non dispone di un abbonamento attivo, questo valore non è incluso nel payload.

Vedi last_event/urls_expire_time per informazioni sulla data 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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

app_url

URL dell'app Nest (link diretto) all'ultimo evento di suono o movimento. Utilizzato per visualizzare l'ultimo evento registrato e richiede che l'utente acceda all'account.

Richiede Nest Aware . Se l'URL dell'evento è scaduto o il dispositivo non dispone di un abbonamento attivo, questo valore non è incluso nel payload.

Vedi last_event/urls_expire_time per informazioni sulla data 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 fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura / v1-v3 Fotocamera lettura / scrittura + immagini / v1-v4

URL dell'immagine

URL (collegamento) al file immagine acquisito per un evento sonoro o di movimento.

Richiede Nest Aware . Vedi last_event/urls_expire_time per informazioni sulla data 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` " Attenzione: `string1` e `string2` vengono utilizzate per effettuare la chiamata API. Non modificare nessuna delle stringhe o la chiamata fallirà.
Accesso	sola lettura
Disponibile in	Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura + immagini / v1-v4

animated_image_url

URL (collegamento) al file gif acquisito per un evento sonoro 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` " Attenzione: `string1` e `string2` vengono utilizzate per effettuare la chiamata API. Non modificare nessuna delle stringhe o la chiamata fallirà.
Accesso	sola lettura
Disponibile in	Lettura fotocamera + immagini / v1-v4 Fotocamera lettura / scrittura + immagini / v1-v4

activity_zone_ids

Identificatori per Zone attive che hanno rilevato un evento di movimento.

Richiede Nest Aware . Se utilizzato con l'array activity_zones , puoi ottenere il nome della zona da questi ID.

Se last_event/has_motion è

true = restituisce gli ID delle zone 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 Fotocamera lettura / scrittura + immagini / v3-v4