Notice: We're retiring Works with Nest. See the home page for more information.
Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

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 termostatiNest ,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 termostatiNest ,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.
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 "
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:

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