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 |
|
İadeler | string Örnek: "awJo6rH..." |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: &4t;4.0 |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: "VqFabWH21nw..." |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: "d6reb_OZTM..." |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: "Hallway" |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: "Hallway" |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: &Hallway Nest Cam (üst kat)" |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | boolean Değerler: true, false |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | boolean Değerler: true, false |
Erişim | okuma/yazma |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | boolean Değerler: true, false |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: "2016-12-29T18:42:00.000Z" |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | boolean Değerler: true, false |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: " https://home.nest.com/cameras/device_id?auth=camera_token &; |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: " nestmobile://cameras/device_id?auth=camera_token &; |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | boolean Değerler: true, false |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | array Ö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şim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: https://video.nest.com/live/string1?string2 Dizeyi değiştirmeyin, aksi takdirde arama başarısız olur. |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: " string1/device_id/string2?auth=camera_token " |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | boolean Değerler: true, false |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | boolean Değerler: true, false |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | boolean Değerler: true, false |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: "2016-12-29T00:00:00.000Z" |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: "2016-12-29T00:00:00.000Z" |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: "2016-12-29T00:00:00.000Z" |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: " https://home.nest.com/cameras/device_id/cuepoints/string?auth=camera_token &; |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: " nestmobile://cameras/device_id/cuepoints/string?auth=camera_token &; |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: " https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token " |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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 |
|
İadeler | string Örnek: " https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token " |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera 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.
true
= hareket etkinliği algılayan etkinlik bölgesi kimliklerini döndürürfalse
= boş 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,... ] |
Erişim | salt okunur |
Kullanıma sunulduğu ülkeler | Kamera okuma + resimler / v3-v4 Kamera okuma/yazma + resimler / v3-v4 |