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

Se last_event/has_motion è

  • 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