L'API Nest funziona con tutti i modelli Nest CamTM.
Gli utenti possono aggiungere più Nest Cam al gruppo devices/cameras
, fino al massimo per struttura.
Quando effettui una chiamata a questa posizione dei dati, puoi accedere ai dati di Nest Cam (valori dei dati per i dispositivi nella struttura).
Tutti i valori seguenti sono riportati sotto ogni devices/cameras/device_id
nel documento JSON.
ID_dispositivo
Identificatore univoco di Nest Cam.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/device_id |
|
Restituisce | string Esempio: "awJo6rH..." |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + immagini / v1-v4 |
versione_software
Versione software.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/software_version |
|
Restituisce | string Esempio: "4.0" |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + immagini / v1-v4 |
struttura_id
Identificatore univoco della struttura.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/structure_id |
|
Restituisce | string Esempio: "VqFabWH21nw..." |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + immagini / v1-v4 |
dove_id
Un identificatore univoco generato da Nest che rappresenta
name
, il nome visualizzato del dispositivo.
Scopri di più su dove si trovano i nomi di Nest Thermostat, Nest Protect e Nest Cam.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/where_id |
|
Restituisce | string Esempio: "d6reb_OZTM..." |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera/v1-v3 Lettura fotocamera + immagini/v1-v4 Lettura/scrittura fotocamera/v1-v3 Lettura/scrittura fotocamera + immagini/v1-v4 |
dove_nome
Il nome visualizzato del dispositivo. Associata a Nest Cam
where_id
. Può essere qualsiasi nome di una stanza da un
elenco fornito da noi o un nome personalizzato. Scopri di più su dove si trovano i nomi di Nest Thermostat, Nest Protect e Nest Cam.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/where_name |
|
Restituisce | string Esempio: "Corridoio" |
Accesso | sola lettura |
Disponibile in | Lettura della fotocamera/v3 Lettura della fotocamera + immagini/v4 Lettura/scrittura della fotocamera/v3 Lettura/scrittura della fotocamera + immagini/v4 |
name
Nome visualizzato del dispositivo; può essere il nome di una stanza da un elenco fornito o un nome personalizzato.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/name |
|
Restituisce | string Esempio: "Corridoio" |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera/v1-v3 Lettura fotocamera + immagini/v1-v4 Lettura/scrittura fotocamera/v1-v3 Lettura/scrittura fotocamera + immagini/v1-v4 |
nome_lungo
Nome visualizzato lungo del dispositivo. Include un'etichetta personalizzata (creata dall'utente) o tramite wheres
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/name_long |
|
Restituisce | string Esempio: "Corridoio Nest Cam (piano superiore)" |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera/v1-v3 Lettura fotocamera + immagini/v1-v4 Lettura/scrittura fotocamera/v1-v3 Lettura/scrittura fotocamera + immagini/v1-v4 |
is_online
Stato di connessione del dispositivo con il servizio Nest.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/is_online |
|
Restituisce | boolean Valori: vero, falso |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera/v1-v3 Lettura fotocamera + immagini/v1-v4 Lettura/scrittura fotocamera/v1-v3 Lettura/scrittura fotocamera + immagini/v1-v4 |
is_streaming
Stato della videocamera, video in streaming attivo o spento oppure spento. Consulta l'articolo Come funziona la videocamera con A casa/Fuori casa per ulteriori informazioni.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/is_streaming |
|
Restituisce | boolean Valori: vero, falso |
Accesso | lettura/scrittura |
Disponibile in | Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + immagini / v1-v4 |
is_audio_input_enabled
Stato del microfono della videocamera, acceso o in ascolto oppure disattivato. Scopri di più sulle impostazioni audio di Nest Cam.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/is_audio_input_enabled |
|
Restituisce | boolean Valori: vero, falso |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + immagini / v1-v4 |
ultimo_cambio_online
Timestamp che identifica l'ultima modifica apportata allo stato online in formato ISO 8601.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_is_online_change |
|
Restituisce | string Esempio: "2016-12-29T18:42:00.000Z" |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + 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 |
|
Restituisce | boolean Valori: vero, falso |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + immagini / v1-v4 |
URL_web
URL web (link diretto) al video stream in diretta all'indirizzo home.nest.com.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/web_url |
|
Restituisce | 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 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + immagini / v1-v4 |
URL_app
URL dell'app (link diretto) al video stream in diretta nell'app Nest.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/app_url |
|
Restituisce | string Esempio: " nestmobile://cameras/device_id?auth=camera_token " |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera/v1-v3 Lettura fotocamera + immagini/v1-v4 Lettura/scrittura fotocamera/v1-v3 Lettura/scrittura fotocamera + immagini/v1-v4 |
is_public_share_enabled
Gli utenti possono scegliere di condividere il loro video e renderlo visibile a tutti. Quando la condivisione pubblica è abilitata, puoi leggere
public_share_url
.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/is_public_share_enabled |
|
Restituisce | boolean Valori: vero, falso |
Accesso | sola lettura |
Disponibile in | Lettura della fotocamera + immagini/v3-v4 Lettura/scrittura della fotocamera + immagini/v3-v4 |
zone_attività
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 video stream. Richiede Nest Aware.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/activity_zones |
|
Restituisce | array Esempio: [ {"name" : "string1", "id" : "string2"},... ] • string1 è il nome della zona, definito dall'utente o generato automaticamente quando la zona viene creata.• string2 è un identificatore assegnato da Nest al momento della creazione della Zona attiva. |
Accesso | sola lettura |
Disponibile in | Lettura della fotocamera + immagini/v3-v4 Lettura/scrittura della fotocamera + immagini/v3-v4 |
Public_share_url
Puoi accedere a questo URL quando un utente rende pubblico il proprio video stream.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/public_share_url |
|
Restituisce | string Esempio: " https://video.nest.com/live/string1?string2 "string1 è il nome del video stream, definito dall'utente o generato automaticamente quando lo stream è impostato come pubblico. |
Accesso | sola lettura |
Disponibile in | Lettura della fotocamera + immagini / v3-v4 Lettura/scrittura della fotocamera + immagini / v3-v4 |
URL_istantanea
Acquisisci un'immagine on demand. Restituisce l'URL di un'immagine acquisita dal video stream in diretta. Richiede che la videocamera sia accesa e attiva in streaming.
Utilizza questo campo per ottenere un'istantanea dal video stream in diretta.
snapshot_url
: restituisce l'URL di un'immagine acquisita dal video stream in diretta- Richiede che la videocamera sia accesa e attiva in streaming
La qualità dello snapshot dell'API è di 1080p solo se sei:
- visualizzazione attiva del flusso della videocamera nell'applicazione
(
web_url
) - visualizzazione attiva dello stream pubblico
(
app_url
) - hai sottoscritto un abbonamento a Nest Aware
Se non stai guardando attivamente lo stream o non hai un abbonamento Nest Aware, l'API non ha un'origine 1080p da cui recuperare uno snapshot a quella risoluzione e genera un'immagine di qualità inferiore. Inoltre, se la larghezza di banda della rete locale è bassa, la risoluzione degli snapshot dell'API potrebbe diminuire di 1080p con Nest Aware.
Scopri di più sui requisiti di larghezza di banda per le videocamere Nest.
A questa chiamata vengono applicate le limitazioni, a seconda dello stato di abbonamento di Nest Aware.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/snapshot_url |
|
Restituisce | string Esempio: " string1/device_id/string2?auth=camera_token " |
Accesso | sola lettura |
Disponibile in | Lettura della fotocamera + immagini/v3-v4 Lettura/scrittura della fotocamera + immagini/v3-v4 |
ultimo_evento
Questo oggetto acquisisce le 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 sono riportati 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 |
|
Restituisce | boolean Valori: vero, falso |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + 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 |
|
Restituisce | boolean Valori: vero, falso |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + immagini / v1-v4 |
ha_persona
Evento persona: è stata rilevata una persona.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_person |
|
Restituisce | boolean Valori: vero, falso |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + immagini / v1-v4 |
start_time
Ora di inizio dell'evento, in formato ISO 8601.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/start_time |
|
Restituisce | string Esempio: "2016-12-29T00:00:00.000Z" |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera/v1-v3 Lettura fotocamera + immagini/v1-v4 Lettura/scrittura fotocamera/v1-v3 Lettura/scrittura fotocamera + immagini/v1-v4 |
end_time
Ora di fine dell'evento, nel formato ISO 8601.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/end_time |
|
Restituisce | string Esempio: "2016-12-29T00:00:00.000Z" |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera / v1-v3 Lettura fotocamera + immagini / v1-v4 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + immagini / v1-v4 |
urls_expire_time
Timestamp, in formato ISO 8601, che identifica la scadenza dei seguenti URL correlati agli eventi.
La scadenza è calcolata come segue:
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 |
|
Restituisce | string Esempio: "2016-12-29T00:00:00.000Z" |
Accesso | sola lettura |
Disponibile in | Lettura fotocamera/v1-v3 Lettura fotocamera + immagini/v1-v4 Lettura/scrittura fotocamera/v1-v3 Lettura/scrittura fotocamera + immagini/v1-v4 |
URL_web
URL web (link diretto) all'ultimo evento sonoro o di movimento all'indirizzo home.nest.com. Utilizzato per visualizzare l'ultimo evento registrato e richiede l'accesso dell'utente 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.
Leggi le last_event/urls_expire_time
per informazioni sulla scadenza di questo URL.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/web_url |
|
Restituisce | 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 Lettura/scrittura fotocamera / v1-v3 Lettura/scrittura fotocamera + immagini / v1-v4 |
URL_app
URL dell'app Nest (link diretto) all'ultimo evento sonoro o di movimento. Consente di visualizzare l'ultimo evento registrato e richiede che l'utente abbia eseguito 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.
Leggi le last_event/urls_expire_time
per informazioni sulla scadenza di questo URL.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/app_url |
|
Restituisce | 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 Lettura/scrittura fotocamera/v1-v3 Lettura/scrittura fotocamera + immagini/v1-v4 |
image_url
URL (link) al file immagine acquisito per un evento sonoro o di movimento.
Richiede Nest Aware. Leggi le
last_event/urls_expire_time
informazioni
sulla data di scadenza dell'URL.
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/image_url |
|
Restituisce | 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 fotocamera + immagini/v1-v4 |
animazione_immagine_url
URL (link) 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 |
|
Restituisce | 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 fotocamera + immagini/v1-v4 |
activity_zone_id [id_area_attività]
Identificatori per le Zone attive che hanno rilevato un evento di movimento.
Richiede Nest Aware. Se utilizzato con l'array
activity_zones
, è possibile ottenere il nome zona da questi ID.
true
= restituisce gli ID zona attiva che hanno rilevato un evento di movimentofalse
= restituisce un array vuoto
Dettagli | |
---|---|
https://developer-api.nest.com/devices/cameras/device_id/last_event/activity_zone_ids |
|
Restituisce | array Esempio: [ string1, string2,... ] |
Accesso | sola lettura |
Disponibile in | Lettura della fotocamera + immagini / v3-v4 Lettura/scrittura della fotocamera + immagini / v3-v4 |