Kamera API'sı

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

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

Aşağıdaki değerlerin tümü JSON belgesindeki her devices/cameras/ device_id altında bulunur.

aygıt_no

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 okuma / v1-v3 Kamera okuma + görüntüleri / 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 okuma / v1-v3 Kamera okuma + görüntüleri / v1-v4 Kamera okuma / yazma / v1-v3 Kamera okuma / yazma + görüntüler / v1-v4

structure_id

Benzersiz tanımlayıcı yapı.

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

where_id

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

Nest Thermostatts , Nest Protects ve Nest Cams için adların nerede olduğu hakkında daha fazla bilgi edinin.

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

where_name

Cihazın görünen adı. Nest Cam ile where_id . Sunduğumuz listeden herhangi bir oda adı veya özel bir ad olabilir. Nest Thermostatts , Nest Protects ve Nest Cams için adların nerede olduğu hakkında daha fazla bilgi edinin.

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

isim

Cihazın görünen adı; sağladığımız listeden 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 okuma / v1-v3 Kamera okuma + görüntüleri / v1-v4 Kamera okuma / yazma / v1-v3 Kamera okuma / yazma + görüntüler / v1-v4

NAME_LONG

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

ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /name_long
İadeler	string Örnek: "Hallway Nest Cam (üst kat)"
Giriş	Sadece oku
Uygun	Kamera okuma / v1-v3 Kamera okuma + görüntüleri / 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: true, false
Giriş	Sadece oku
Uygun	Kamera okuma / v1-v3 Kamera okuma + görüntüleri / v1-v4 Kamera okuma / yazma / v1-v3 Kamera okuma / yazma + görüntüler / v1-v4

is_streaming

Kamera durumu, açık ve aktif video akışı veya kapalı. Daha fazla bilgi için Kameranızın Ev / Deplasman Yardımı ile nasıl çalıştığını görün.

ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /is_streaming
İadeler	boolean Değerler: true, false
Giriş	okuma yazma
Uygun	Kamera okuma / v1-v3 Kamera okuma + görüntüleri / 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ı. Nest Cam ses ayarları hakkında daha fazla bilgi edinin.

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

last_is_online_change

Çevrimiçi durumdaki son değişikliği ISO 8601 biçiminde tanımlayan zaman damgası.

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 okuma / v1-v3 Kamera okuma + görüntüleri / 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 etkin veya etkin değil).

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

web_url değeri

Home.nest.com adresindeki canlı video akışına web URL'si (derin bağlantı).

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 okuma / v1-v3 Kamera okuma + görüntüleri / v1-v4 Kamera okuma / yazma / v1-v3 Kamera okuma / yazma + görüntüler / v1-v4

APP_URL

Nest uygulamasındaki canlı video akışına 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 okuma / v1-v3 Kamera okuma + görüntüleri / v1-v4 Kamera okuma / yazma / v1-v3 Kamera okuma / yazma + görüntüler / v1-v4

is_public_share_enabled

Kullanıcılar videolarını paylaşmayı ve herkes tarafından görüntülenmesini sağlayabilir. Herkese açık paylaşım etkinleştirildiğinde, public_share_url okuyabilirsiniz.

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

activity_zones

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

Etkinlik Bölgeleri , video akışının kullanıcı tanımlı alanlarındaki hareket olaylarını izlemek için kullanılır. Nest Aware gerektirir.

ayrıntılar
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
İadeler	array Örnek: [ {"name" : " string1 ", "id" : " string2 "},... ] • string1 , kullanıcı tanımlı veya bölge oluşturulduğunda otomatik olarak oluşturulan bölge adıdır. • string2 , Etkinlik Bölgesi oluşturulduğunda Nest tarafından atanan bir tanımlayıcıdır.
Giriş	Sadece oku
Uygun	Kamera okuma + görüntüleri / v3-v4 Kamera okuma / yazma + görüntüler / v3-v4

public_share_url

Bir kullanıcı video akışını herkese açık hale getirdiğinde bu URL'ye erişebilirsiniz.

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 , kullanıcı tanımlı veya akış herkese açık olarak ayarlandığında otomatik olarak oluşturulan video akışı adıdır.
Giriş	Sadece oku
Uygun	Kamera okuma + görüntüleri / v3-v4 Kamera okuma / yazma + görüntüler / v3-v4

SNAPSHOT_URL

Talep üzerine bir görüntü yakalayın. Canlı video akışından yakalanan bir resmin URL'sini döndürür. Kameranın açık ve aktif olarak akış yapmasını gerektirir.

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

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

Aşağıdaki durumlarda API'daki anlık görüntü kalitesi yalnızca 1080p verimdir:

• uygulamada kamera akışını etkin bir şekilde görüntüleme ( web_url )
• herkese açık akışı etkin bir şekilde görüntüleme ( app_url )
• Nest Aware'a abone oldu

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

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

Nest Aware abonelik durumuna bağlı olarak bu çağrılar için ücret sınırları geçerlidir.

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üleri / v3-v4 Kamera okuma / yazma + görüntüler / v3-v4

son olay

Bu nesne, bir bildirimi tetikleyen son olay hakkında bilgi toplar.

Bazı alanlar ve bazı izin kombinasyonları, son etkinlik bilgilerine erişmek için Nest Aware aboneliği gerektirir.

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: true, false
Giriş	Sadece oku
Uygun	Kamera okuma / v1-v3 Kamera okuma + görüntüleri / 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: true, false
Giriş	Sadece oku
Uygun	Kamera okuma / v1-v3 Kamera okuma + görüntüleri / v1-v4 Kamera okuma / yazma / v1-v3 Kamera okuma / yazma + görüntüler / v1-v4

has_person

Kişi olayı - bir kişi tespit edildi.

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

Başlangıç ​​saati

Olay başlangıç ​​zamanı, ISO 8601 formatında.

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 okuma / v1-v3 Kamera okuma + görüntüleri / v1-v4 Kamera okuma / yazma / v1-v3 Kamera okuma / yazma + görüntüler / v1-v4

bitiş zamanı

Olay bitiş zamanı, ISO 8601 formatında.

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 okuma / v1-v3 Kamera okuma + görüntüleri / v1-v4 Kamera okuma / yazma / v1-v3 Kamera okuma / yazma + görüntüler / v1-v4

urls_expire_time

Olayla ilgili bu URL'lerin sona erme süresini tanımlayan ISO 8601 biçimindeki zaman damgası:

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

Son kullanma süresi, last_event/start_time + n gün olarak hesaplanır (burada, Nest Aware abonelik planına bağlı olarak n = 10 veya 30 gün).

Nest Aware gerektirir.

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 okuma / v1-v3 Kamera okuma + görüntüleri / v1-v4 Kamera okuma / yazma / v1-v3 Kamera okuma / yazma + görüntüler / v1-v4

web_url değeri

Home.nest.com adresindeki son ses veya hareket etkinliğinin web URL'si (derin bağlantı). Son kaydedilen etkinliği görüntülemek için kullanılır ve kullanıcının hesapta oturum açmasını gerektirir.

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

Bu URL'nin sona erme süresi hakkında bilgi için last_event/urls_expire_time bakın.

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 okuma / v1-v3 Kamera okuma + görüntüleri / v1-v4 Kamera okuma / yazma / v1-v3 Kamera okuma / yazma + görüntüler / v1-v4

APP_URL

Uygulama URL'sini (derin bağlantı) son ses veya hareket etkinliğine yerleştirme. Son kaydedilen etkinliği görüntülemek için kullanılır ve kullanıcının hesapta oturum açmasını gerektirir.

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

Bu URL'nin sona erme süresi hakkında bilgi için last_event/urls_expire_time bakın.

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 okuma / v1-v3 Kamera okuma + görüntüleri / 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ısı).

Nest Aware gerektirir. Bu URL'nin sona erme süresi hakkında bilgi için last_event/urls_expire_time bakın.

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 okuma + görüntüleri / v1-v4 Kamera okuma / yazma + görüntüler / v1-v4

animated_image_url

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

Nest Aware gerektirir.

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 okuma + görüntüleri / v1-v4 Kamera okuma / yazma + görüntüler / v1-v4

activity_zone_ids

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

Nest Aware gerektirir. activity_zones dizisi ile kullanıldığında, bölge adlarını bu kimliklerden alabilirsiniz.

last_event/has_motion ise

• true = bir hareket olayı algılayan etkinlik bölgesi kimliklerini döndürür
• false = boş bir dizi döndürür

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üleri / v3-v4 Kamera okuma / yazma + görüntüler / v3-v4