Google is committed to advancing racial equity for Black communities. See how.

Kamera API'sı

Nest API, tüm Nest Cam™ modelleriyle çalışır.

Kullanıcılar için birden Nest Kameralar ekleyebilir devices/cameras için, grubun yukarı yapının başına maksimum . Bu veri konumuna çağrı yaptığınızda Nest Cam verilerine (yapıdaki cihazlar için veri değerleri) erişebilirsiniz.

Değerlerin altında tüm her birinin altında bulunan devices/cameras/ device_id JSON belgede.

device_id

Nest Cam benzersiz tanımlayıcısı.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /device_id
İadeler string
Örnek: "awJo6rH..."
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

yazılım versiyonu

Yazılım versiyonu.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /software_version
İadeler string
Örnek: "4.0"
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

yapı_kimliği

Yapı benzersiz tanımlayıcısı.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
İadeler string
Örnek: "VqFabWH21nw..."
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

nerede_kimlik

Temsil eden bir tek, Yuva oluşturulan tanımlayıcı name cihazın görüntü adı.

Daha fazla bilgi için isimleri nerede öğrenin Nest Termostatlar ,Nest korur ve Yuvası Kameralar .

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /where_id
İadeler string
Örnek: "d6reb_OZTM..."
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

nerede_adı

Cihazın görünen adı. Nest Cam ile İlişkili where_id . Sağladığımız bir listedeki herhangi bir oda adı veya özel bir ad olabilir. Daha fazla bilgi için isimleri nerede öğrenin Nest Termostatlar ,Nest korur ve Yuvası Kameralar .

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /where_name
İadeler string
Örnek: "Koridor"
Giriş Sadece oku
Uygun Kamera okuması / v3
Kamera okuma + görüntüler / v4
Kamera okuma/yazma / v3
Kamera okuma/yazma + görüntüler / v4

isim

Cihazın görünen adı; Sağladığımız bir listedeki herhangi bir oda adı veya özel bir ad olabilir.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /name
İadeler string
Örnek: "Koridor"
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

isim_uzun

Cihazın uzun görünen adı. Kullanıcı tarafından oluşturulan özel (etiket), içerir veya üzeri wheres .

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /name_long
İadeler string
Örnek: "Koridor Yuva Kamerası (üst katta)"
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

is_online

Nest hizmetiyle cihaz bağlantı durumu.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /is_online
İadeler boolean
Değerler: doğru, yanlış
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

is_streaming

Kamera durumu, açık ve aktif olarak video akışı ya da kapalı. Bkz kameranız Evde nasıl çalışır? / Dışarıda Assist fazla bilgi için.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
İadeler boolean
Değerler: doğru, yanlış
Giriş okuma yazma
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

is_audio_input_enabled

Kamera mikrofon durumu, açık ve dinleme veya kapalı. Hakkında daha fazla bilgi Nest Cam ses ayarları .

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /is_audio_input_enabled
İadeler boolean
Değerler: doğru, yanlış
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

last_is_online_change

İçinde, çevrimiçi durumuna son değişikliği tanımlayan Damgası ISO 8601 formatında.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_is_online_change
İadeler string
Örnek: "2016-12-29T18:42:00.000Z"
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

is_video_history_enabled

Nest Aware abonelik durumu (abonelik aktif veya değil).

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /is_video_history_enabled
İadeler boolean
Değerler: doğru, yanlış
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

web_url

Web URL adresi canlı video akışı için (derin bağlantı) home.nest.com .

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /web_url
İadeler string
Örnek: " https://home.nest.com/cameras/ device_id ?auth= camera_token "
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

app_url

Nest uygulamasındaki canlı video akışının uygulama URL'si (derin bağlantı).

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /app_url
İadeler string
Örnek: " nestmobile://cameras/ device_id ?auth= camera_token "
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

is_public_share_enabled

Kullanıcılar seçebilirsiniz onların video paylaşmak ve herkes tarafından görüntülenebilir olun. Kamu payı etkinleştirildiğinde, okuyabilir public_share_url .

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /is_public_share_enabled
İadeler boolean
Değerler: doğru, yanlış
Giriş Sadece oku
Uygun Kamera okuma + görüntüler / v3-v4
Kamera okuma/yazma + görüntüler / v3-v4

aktivite_bölgeleri

Tanımlanmış tüm Etkinlik Bölgelerinin bir dizisini döndürür.

Etkinlik Bölgeler Video akışının kullanıcı tanımlı alanlar içinde hareket olayları izlemek için kullanılır. Gerektirir Nest Aware .

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
İadeler array
Örnek: [ {"name" : " string1 ", "id" : " string2 "},... ]

string1 bölgesi adı, kullanıcı tanımlı bölge oluşturulduktan oluşturulan otomatik veya.
string2 Etkinlik Bölge oluşturulduğunda Nest tarafından atanan bir tanımlayıcıdır.
Giriş Sadece oku
Uygun Kamera okuma + görüntüler / v3-v4
Kamera okuma/yazma + görüntüler / v3-v4

public_share_url

Bir kullanıcı yaptığında Bu URL'yi erişebilir video akışı halkı .

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
İadeler string
Örnek: " https://video.nest.com/live/ string1 ? string2 "

string1 , video akışı adı kullanıcı tanımlı akış halka ayarlandığında oluşturulan otomatik veya.
Giriş Sadece oku
Uygun Kamera okuma + görüntüler / v3-v4
Kamera okuma/yazma + görüntüler / v3-v4

snapshot_url

İsteğe bağlı olarak bir görüntü yakalayın. Canlı video akışından yakalanan bir görüntünün URL'sini döndürür. Kameranın açık ve aktif olarak akış halinde olmasını gerektirir.

Canlı video akışından bir anlık görüntü almak için bu alanı kullanın.

  • snapshot_url - canlı video akışı yakalanan bir resmin URL'sini döndürür
  • Kameranın açık olmasını ve aktif olarak akışını gerektirir

Aşağıdaki durumlarda API'den alınan anlık görüntü kalitesi yalnızca 1080p çıktıdır:

  • aktif uygulamada kamera akışını inceleyen ( web_url )
  • aktif kamu akışını inceleyen ( app_url )
  • Nest Aware'e abone olun

Akışı aktif olarak görüntülemiyorsanız veya Nest Aware aboneliğiniz yoksa API'nin bu çözünürlükte anlık görüntü alabileceği 1080p kaynağı yoktur ve daha düşük kaliteli bir görüntü oluşturur. Ayrıca, düşük yerel ağ bant genişliği, Nest Aware mevcutken API anlık görüntü çözünürlüğünün 1080p'nin altına düşmesine neden olabilir.

Hakkında daha fazla bilgi Nest Kameralar için bant genişliği gereksinimleri .

Puan limitleri Nest Aware bağlı olarak, bu çağrıya geçerli abonelik durumuna .

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url
İadeler string
Örnek: " string1 / device_id / string2 ?auth= camera_token "
Giriş Sadece oku
Uygun Kamera okuma + görüntüler / v3-v4
Kamera okuma/yazma + görüntüler / v3-v4

son olay

Bu nesne, bir bildirimi tetikleyen son olayla ilgili bilgileri yakalar.

Bazı alanlar ve bazı izin kombinasyonları bir ihtiyaç Nest Aware son olay bilgilere erişmek için abonelik.

Değerlerin altında tüm her birinin altında bulunan devices/cameras/ device_id /last_event JSON belgede.

has_sound

Ses olayı - ses algılandı.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_sound
İadeler boolean
Değerler: doğru, yanlış
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

has_motion

Hareket olayı - hareket algılandı.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_motion
İadeler boolean
Değerler: doğru, yanlış
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

has_person

Kişi olayı - bir kişi algılandı.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_event/has_person
İadeler boolean
Değerler: doğru, yanlış
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

Başlangıç ​​saati

Etkinlik başlangıç zamanı, içinde ISO 8601 biçiminde.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_event/start_time
İadeler string
Örnek: "2016-12-29T00:00:00.000Z"
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

bitiş zamanı

Etkinlik bitiş saati, içinde ISO 8601 biçiminde.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_event/end_time
İadeler string
Örnek: "2016-12-29T00:00:00.000Z"
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

urls_expire_time

Zaman Damgası, içinde ISO 8601 biçimi, yani tanımlar bu olaya ilişkin URL'lerin son kullanma:

: Süre bitiş zamanı olarak hesaplanır last_event/start_time + n gün (n = 10 ya da 30 gün, Yuva farkında bağlı olarak abonelik planı ).

Gerektirir Nest Aware .

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_event/urls_expire_time
İadeler string
Örnek: "2016-12-29T00:00:00.000Z"
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

web_url

Web URL en son ses veya hareketli olay (derin bağlantı) home.nest.com . Son kaydedilen olayı görüntülemek için kullanılır ve kullanıcının hesapta oturum açmasını gerektirir.

Gerektirir Nest Aware . Etkinlik URL'sinin süresi dolmuşsa veya cihazın aktif bir aboneliği yoksa bu değer yüke dahil edilmez.

Bkz last_event/urls_expire_time bu URL sona erme zamanında bilgi almak için.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url
İadeler string
Örnek: " https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token "
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

app_url

Son ses veya hareket etkinliğine yönelik Nest uygulaması URL'si (derin bağlantı). Son kaydedilen olayı görüntülemek için kullanılır ve kullanıcının hesapta oturum açmasını gerektirir.

Gerektirir Nest Aware . Etkinlik URL'sinin süresi dolmuşsa veya cihazın aktif bir aboneliği yoksa bu değer yüke dahil edilmez.

Bkz last_event/urls_expire_time bu URL sona erme zamanında bilgi almak için.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url
İadeler string
Örnek: " nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token "
Giriş Sadece oku
Uygun Kamera okuması / v1-v3
Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + görüntüler / v1-v4

image_url

Bir ses veya hareket olayı için yakalanan görüntü dosyasının URL'si (bağlantı).

Gerektirir Nest Aware . Bkz last_event/urls_expire_time bu URL sona erme zamanında bilgi almak için.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_event/image_url
İadeler string
Örnek: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Giriş Sadece oku
Uygun Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma + görüntüler / v1-v4

animasyonlu_image_url

Bir ses veya hareket olayı için yakalanan gif dosyasının URL'si (bağlantısı).

Gerektirir Nest Aware .

Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_event/animated_image_url
İadeler string
Örnek: " https://www.dropcam.com/api/wwn.get_image/ string1 / device_id / string2 ?auth= camera_token "
Giriş Sadece oku
Uygun Kamera okuması + görüntüler / v1-v4
Kamera okuma/yazma + görüntüler / v1-v4

aktivite_zone_ids

Bir hareket olayı algılayan Etkinlik Bölgeleri için tanımlayıcılar.

Gerektirir Nest Aware . Birlikte kullanıldığında activity_zones dizisi, bu kimlikleri gelen bölge ismini alabilirsiniz.

Eğer last_event/has_motion isimli

  • true = bir hareket olayı tespit aktivite bölgesi kimlikleri döndürür
  • false = boş bir dizi döner
Ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /last_event/activity_zone_ids
İadeler array
Örnek: [ string1 , string2 ,... ]
Giriş Sadece oku
Uygun Kamera okuma + görüntüler / v3-v4
Kamera okuma/yazma + görüntüler / v3-v4