Kamera API'si

Nest API tüm Nest CamTM modelleriyle çalışır.

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

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

cihaz_kimliği

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

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/device_id
İadelerstring
Örnek: "awJo6rH..."
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

yazılım_sürümü

Yazılım sürümü.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/software_version
İadelerstring
Örnek: &4t;4.0
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

yapısı_kimliği

Benzersiz tanımlayıcıyı yapılandırın.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/structure_id
İadelerstring
Örnek: "VqFabWH21nw..."
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

yeri_kimliği

Cihazın görünen adı olan name'i temsil eden, Nest tarafından oluşturulan benzersiz tanımlayıcı.

Nest Thermostat, Nest Protect ve Nest Cam için adlar hakkında daha fazla bilgi edinin.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/where_id
İadelerstring
Örnek: "d6reb_OZTM..."
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

yer_adı

Cihazın görünen adı. Nest Cam where_id ile ilişkilendirilmiştir. Belirttiğimiz bir listedeki herhangi bir oda adı veya özel bir ad olabilir. Nest Thermostat, Nest Protect ve Nest Cam için adlar hakkında daha fazla bilgi edinin.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/where_name
İadelerstring
Örnek: "Hallway"
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v3
Kamera okuma + resimler / v4
Kamera okuma/yazma / v3
Kamera okuma/yazma + resimler / v4

ad

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

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/name
İadelerstring
Örnek: "Hallway"
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

ad_uzun

Cihazın uzun görünen adı. Kullanıcı veya wheres aracılığıyla oluşturulan özel (etiket) etiketleri içerir.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/name_long
İadelerstring
Örnek: &Hallway Nest Cam (üst kat)"
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

çevrimiçi

Nest hizmetiyle cihaz bağlantısı durumu.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/is_online
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

is_streaming

Kameranın açık veya canlı video akışı ya da kapalı olma durumu. Kameranızın Evde/Dışarıda ile nasıl çalışır? Daha fazla bilgi için bkz.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/is_streaming
İadelerboolean
Değerler: true, false
Erişimokuma/yazma
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

is_audio_input_enabled

Kameranın mikrofon durumu açık veya dinleniyor, 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
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / 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
İadelerstring
Örnek: "2016-12-29T18:42:00.000Z"
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

is_video_history_enabled:

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

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/is_video_history_enabled
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

web_url'si

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

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/web_url
İadelerstring
Örnek: "https://home.nest.com/cameras/device_id?auth=camera_token&;
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

uygulama_url'si

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
İadelerstring
Örnek: "nestmobile://cameras/device_id?auth=camera_token&;
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

is_public_share_enabled

Kullanıcılar videolarını paylaşmayı ve herkes tarafından görüntülenebilir olmayı seçebilir. Herkese açık paylaşım etkinleştirildiğinde şunu okuyabilirsiniz: public_share_url.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/is_public_share_enabled
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma + resimler / v3-v4
Kamera okuma/yazma + resimler / v3-v4

event_zones

Tanımlı tüm Etkinlik Bölgelerinin dizisini döndürür.

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

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

string1, kullanıcı adı olan veya bölge oluşturulduğunda otomatik olarak oluşturulan alt bölge adıdır.
string2, Etkinlik Bölgesi oluşturulurken Nest tarafından atanan bir tanımlayıcıdır.
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma + resimler / v3-v4
Kamera okuma/yazma + resimler / v3-v4

herkese açık_paylaşım_url'si

Bir kullanıcı video akışını herkese açık olarak ayarladığında bu URL'ye erişebilirsiniz.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/public_share_url
İadelerstring
Örnek: https://video.nest.com/live/string1?string2 Dizeyi değiştirmeyin, aksi takdirde arama başarısız olur.
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma + resimler / v3-v4
Kamera okuma/yazma + resimler / v3-v4

anlık görüntü_url'si

İsteğe bağlı olarak resim çekin. Canlı video akışından alınan bir resmin URL'sini döndürür. Kameranın açık ve etkin akışlı olması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 yayın yapmasını gerektiriyor

Aşağıdaki durumlarda API'nin anlık görüntü kalitesi yalnızca 1080p işleme hızıdır:

  • uygulamada kamera akışını aktif olarak görüntüleme (web_url)
  • Herkese açık akışı aktif olarak görüntüleme (app_url)
  • Nest Aware'e abone oldu

Akışı etkin bir şekilde görüntülemiyorsanız veya Nest Aware aboneliğiniz yoksa API'nin bu çözünürlükte 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 ile birlikte 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 görüşme için hız sınırları geçerlidir.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/snapshot_url
İadelerstring
Örnek: "string1/device_id/string2?auth=camera_token"
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma + resimler / v3-v4
Kamera okuma/yazma + resimler / v3-v4

son_etkinlik

Bu nesne, bildirimi tetikleyen son etkinlikle ilgili bilgileri yakalar.

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

Aşağıdaki değerlerin tümü, JSON dokümanındaki her devices/cameras/device_id/last_event altında bulunur.

has_audio

Ses etkinliği - ses algılandı.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_sound
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

has_motion

Hareket etkinliği - hareket algılandı.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_motion
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

has_person

Kişi etkinliği - bir kişi algılandı.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_person
İadelerboolean
Değerler: true, false
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

başlangıç_süresi

ISO 8601 biçiminde etkinlik başlangıç zamanı.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/last_event/start_time
İadelerstring
Örnek: "2016-12-29T00:00:00.000Z"
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

bitiş_süresi

Etkinlik bitiş zamanı, ISO 8601 biçiminde.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/last_event/end_time
İadelerstring
Örnek: "2016-12-29T00:00:00.000Z"
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

url'ler_süresi_süresi

Etkinlikle ilgili aşağıdaki URL'lerin süresinin ne zaman tanımlandığını gösteren ISO 8601 biçimindeki zaman damgası:

Son kullanma tarihi şöyle hesaplanır: last_event/start_time + n gün (burada n = 10 veya 30 gün, Nest Aware abonelik planına bağlıdır).

Nest Aware gerektirir.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/last_event/urls_expire_time
İadelerstring
Örnek: "2016-12-29T00:00:00.000Z"
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

web_url'si

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

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

Bu URL'nin son kullanma tarihiyle ilgili bilgi için last_event/urls_expire_time konusuna bakın.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/last_event/web_url
İadelerstring
Örnek: "https://home.nest.com/cameras/device_id/cuepoints/string?auth=camera_token&;
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

uygulama_url'si

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

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

Bu URL'nin son kullanma tarihiyle ilgili bilgi için last_event/urls_expire_time konusuna bakın.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/last_event/app_url
İadelerstring
Örnek: "nestmobile://cameras/device_id/cuepoints/string?auth=camera_token&;
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma / v1-v3
Kamera okuma + resimler / v1-v4
Kamera okuma/yazma / v1-v3
Kamera okuma/yazma + resimler / v1-v4

resim_url'si

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

Nest Aware gerektirir. Bu URL'nin son kullanma tarihiyle ilgili bilgi için last_event/urls_expire_time konusuna bakın.

Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/last_event/image_url
İadelerstring
Örnek: "https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token"
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma + resimler / v1-v4
Kamera okuma/yazma + resimler / v1-v4

animasyonlu_resim_url'si

Bir ses veya hareket etkinliği 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
İadelerstring
Örnek: "https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token"
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma + resimler / v1-v4
Kamera okuma/yazma + resimler / v1-v4

event_zone_id'ler

Hareket etkinliği algılayan Etkinlik Bölgeleri için tanımlayıcılar.

Nest Aware gerektirir. activity_zones dizisiyle kullanıldığında bu kimliklerden bölge adını alabilirsiniz.

last_event/has_motion ise

  • true = hareket etkinliği algılayan etkinlik bölgesi kimliklerini döndürür
  • false = boş dizi döndürür
Ayrıntılar
https://developer-api.nest.com/devices/cameras/device_id/last_event/activity_zone_ids
İadelerarray
Örnek: [ string1, string2,... ]
Erişimsalt okunur
Kullanıma sunulduğu ülkelerKamera okuma + resimler / v3-v4
Kamera okuma/yazma + resimler / v3-v4