कैमरा एपीआई

Nest API, सभी Nest CamTM मॉडल के साथ काम करता है.

उपयोगकर्ता devices/cameras ग्रुप में एक से ज़्यादा Nest Cam जोड़ सकते हैं. ज़्यादा से ज़्यादा हर स्ट्रक्चर को चुना जा सकता है. इस डेटा लोकेशन पर कॉल करने के दौरान, आप Nest Cam का डेटा (स्ट्रक्चर्ड डेटा में दिए गए डिवाइस के लिए डेटा मान) ऐक्सेस कर सकते हैं.

नीचे दिए गए सभी मान, JSON दस्तावेज़ में मौजूद हर devices/cameras/device_id के तहत मिलते हैं.

device_id

Nest Cam यूनीक आइडेंटिफ़ायर.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/device_id
लौटाए गए सामानstring
उदाहरण: &quat;awJo6rH...&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

सॉफ़्टवेयर_वर्शन

सॉफ़्टवेयर का वर्शन.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/software_version
लौटाए गए सामानstring
उदाहरण: &कोटेशन;4.0&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

संरचना_आईडी

यूनीक आइडेंटिफ़ायर बनाएं.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/structure_id
लौटाए गए सामानstring
उदाहरण: &quat;VqFabWH21nw...&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

Where_id

Nest से जनरेट किया गया एक यूनीक आइडेंटिफ़ायर, जो डिवाइस के डिसप्ले नाम name के बारे में बताता है.

Nest Thermostat, Nest Protect, और Nest Cam के नाम के बारे में ज़्यादा जानें.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/where_id
लौटाए गए सामानstring
उदाहरण: &कोटेशन;d6reb_OZTM...&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

Where_name

डिवाइस का डिसप्ले नाम. Nest Cam where_id से जुड़ा. आप हमारी सूची में से कोई चैट रूम या पसंद के मुताबिक कोई नाम दे सकते हैं. Nest Thermostat, Nest Protect, और Nest Cam के नाम के बारे में ज़्यादा जानें.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/where_name
लौटाए गए सामानstring
उदाहरण: "Hallway&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v3
कैमरा रीड + इमेज / v4
कैमरा रीड/राइट / v3
कैमरा रीड/राइट + इमेज / v4

नाम

डिवाइस का डिसप्ले नाम; सूची में से कोई भी नाम दे सकते हैं या पसंद के मुताबिक कोई नाम दे सकते हैं.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/name
लौटाए गए सामानstring
उदाहरण: "Hallway&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

name_long

डिवाइस का लंबा डिसप्ले नाम. इसमें उपयोगकर्ता या wheres की मदद से बनाया गया एक कस्टम लेबल शामिल है.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/name_long
लौटाए गए सामानstring
उदाहरण: &कोटेशन हॉल Nest Cam (ऊपर की ओर)&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

is_online

Nest सेवा के साथ डिवाइस कनेक्शन की स्थिति.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/is_online
लौटाए गए सामानboolean
वैल्यू: सही, गलत
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

is_streaming

कैमरे की स्थिति, वीडियो चालू करने या सक्रिय रूप से स्ट्रीम करने या बंद करने के लिए. ज़्यादा जानकारी के लिए आपका कैमरा होम/अवे Assistant के कैसे काम करता है देखें.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/is_streaming
लौटाए गए सामानboolean
वैल्यू: सही, गलत
ऐक्सेस करनापढ़ें/लिखें
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

is_audio_input_Enabled

कैमरे के माइक्रोफ़ोन की स्थिति, चालू या बंद या बंद होने पर. Nest Cam की ऑडियो सेटिंग के बारे में ज़्यादा जानें.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/is_audio_input_enabled
लौटाए गए सामानboolean
वैल्यू: सही, गलत
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

last_is_online_change

ISO 8601 फ़ॉर्मैट में, ऑनलाइन स्टेटस में हुए आखिरी बदलाव की पहचान करने वाला टाइमस्टैंप.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_is_online_change
लौटाए गए सामानstring
उदाहरण: &कोटेशन;2016-12-29T18:42:00.000Z&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

is_video_history_Enabled

Nest Aware सदस्यता की स्थिति (सदस्यता चालू है या नहीं).

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/is_video_history_enabled
लौटाए गए सामानboolean
वैल्यू: सही, गलत
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

web_url

home.nest.com पर लाइव वीडियो स्ट्रीम का वेब यूआरएल (डीप लिंक).

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/web_url
लौटाए गए सामानstring
उदाहरण: &quat;https://home.nest.com/cameras/device_id?auth=camera_token&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

app_url (ऐप्लिकेशन_का_यूआरएल)

Nest ऐप्लिकेशन में लाइव वीडियो स्ट्रीम का ऐप्लिकेशन यूआरएल (डीप लिंक).

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/app_url
लौटाए गए सामानstring
उदाहरण: &quat;nestmobile://cameras/device_id?auth=camera_token&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

is_public_share_Enabled

उपयोगकर्ता अपना वीडियो शेयर करने और यह तय करने का विकल्प चुन सकते हैं कि वह वीडियो सभी को दिखे. सार्वजनिक तौर पर शेयर करने की सुविधा चालू होने पर, आप public_share_url पढ़ सकते हैं.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/is_public_share_enabled
लौटाए गए सामानboolean
वैल्यू: सही, गलत
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड + इमेज / v3-v4
कैमरा रीड/राइट + इमेज / v3-v4

activity_zones

तय किए गए सभी ऐक्टिविटी ज़ोन की कैटगरी दिखाता है.

गतिविधि क्षेत्र का इस्तेमाल वीडियो स्ट्रीम में उपयोगकर्ता की तय की गई जगहों पर होने वाले मोशन इवेंट की निगरानी करने के लिए किया जाता है. Nest Aware की ज़रूरत है.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/activity_zones
लौटाए गए सामानarray
उदाहरण: [ {"name" : "string1", "id" : "string2"},... ]

string1 ज़ोन का नाम है, जो ज़ोन बनने के बाद उपयोगकर्ताओं ने तय किया है या अपने-आप जनरेट किया है.
• ऐक्टिविटी ज़ोन बनाने के दौरान, string2, Nest को असाइन किया गया आइडेंटिफ़ायर होता है.
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड + इमेज / v3-v4
कैमरा रीड/राइट + इमेज / v3-v4

public_share_url

जब कोई उपयोगकर्ता अपनी वीडियो स्ट्रीम सार्वजनिक करता है, तब आप इस यूआरएल को ऐक्सेस कर सकते हैं.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/public_share_url
लौटाए गए सामानstring
उदाहरण: "https://video.nest.com/live/string1?string2&kot;

string1 वीडियो स्ट्रीम का नाम है, जो स्ट्रीम के सार्वजनिक होने पर सेट किए जाने पर उपयोगकर्ता की ओर से तय किया गया होता है या अपने-आप जनरेट होता है.
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड + इमेज / v3-v4
कैमरा रीड/राइट + इमेज / v3-v4

स्नैपशॉट_यूआरएल

मांग पर इमेज कैप्चर करें. लाइव वीडियो स्ट्रीम से कैप्चर की गई इमेज का यूआरएल दिखाता है इसके लिए, कैमरा चालू होना चाहिए और स्ट्रीम हो रहा हो.

लाइव वीडियो स्ट्रीम से स्नैपशॉट पाने के लिए, इस फ़ील्ड का इस्तेमाल करें.

  • snapshot_url - लाइव वीडियो स्ट्रीम से कैप्चर की गई इमेज का यूआरएल दिखाता है
  • इसके लिए कैमरा चालू है और चालू से स्ट्रीम किया जा रहा है

एपीआई के स्नैपशॉट की क्वालिटी सिर्फ़ 1080p तब मिलेगी, जब आप:

  • ऐप्लिकेशन में कैमरा स्ट्रीम सही तरीके से देख रहा है (web_url)
  • सार्वजनिक स्ट्रीम देखना (app_url)
  • Nest Aware की सदस्यता ली

अगर आप सक्रिय रूप से स्ट्रीम नहीं देख रहे हैं या आपके पास Nest Aware की सदस्यता नहीं है, तो एपीआई में 1080p स्रोत नहीं होता है. इससे स्रोत को उस रिज़ॉल्यूशन पर फिर से स्नैपशॉट मिलता है और हल्की क्वालिटी वाली इमेज जनरेट होती है. साथ ही, कम लोकल नेटवर्क बैंडविड्थ की वजह से, एपीआई स्नैपशॉट का रिज़ॉल्यूशन 1080p से कम हो सकता है.

Nest कैमरे के लिए बैंडविड्थ की ज़रूरी शर्तों के बारे में ज़्यादा जानें.

कॉल की दर, इस कॉल पर लागू होती है. यह Nest Aware की सदस्यता की स्थिति पर निर्भर करता है.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/snapshot_url
लौटाए गए सामानstring
उदाहरण: &कोटेशन;string1/device_id/string2?auth=camera_token&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड + इमेज / v3-v4
कैमरा रीड/राइट + इमेज / v3-v4

last_event

यह ऑब्जेक्ट, आखिरी इवेंट की जानकारी कैप्चर करता है जिसने सूचना ट्रिगर की थी.

कुछ फ़ील्ड और अनुमतियों के कुछ कॉम्बिनेशन में, आखिरी इवेंट की जानकारी को ऐक्सेस करने के लिए, Nest Aware की सदस्यता ज़रूरी होती है.

नीचे दिए गए सभी मान, JSON दस्तावेज़ में मौजूद हर devices/cameras/device_id/last_event के तहत मिलते हैं.

is_sound

साउंड इवेंट - आवाज़ का पता चला.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_sound
लौटाए गए सामानboolean
वैल्यू: सही, गलत
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

is_motion

मोशन इवेंट - हलचल का पता चला है.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_motion
लौटाए गए सामानboolean
वैल्यू: सही, गलत
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

is_person

किसी व्यक्ति की गतिविधि - व्यक्ति की पहचान की गई.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_event/has_person
लौटाए गए सामानboolean
वैल्यू: सही, गलत
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

start_time

इवेंट की शुरुआत का समय, ISO 8601 फ़ॉर्मैट में.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_event/start_time
लौटाए गए सामानstring
उदाहरण: &कोटेशन;2016-12-29T00:00:00.000Z"
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

end_time

इवेंट के खत्म होने का समय, ISO 8601 फ़ॉर्मैट में.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_event/end_time
लौटाए गए सामानstring
उदाहरण: &कोटेशन;2016-12-29T00:00:00.000Z"
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

urls_expire_time

ISO 8601 फ़ॉर्मैट में टाइमस्टैंप, जो इन इवेंट से जुड़े यूआरएल की समयसीमा की पहचान करता है:

खत्म होने का समय इस तरह निकाला जाता है: last_event/start_time + n दिन (जहां n = 10 या 30 दिन, Nest Aware की सदस्यता प्लान पर निर्भर करता है).

Nest Aware की ज़रूरत है.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_event/urls_expire_time
लौटाए गए सामानstring
उदाहरण: &कोटेशन;2016-12-29T00:00:00.000Z"
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

web_url

home.nest.com पर पिछले साउंड या मोशन इवेंट का वेब यूआरएल (डीप लिंक). इसका इस्तेमाल आखिरी बार रिकॉर्ड किए गए इवेंट को दिखाने के लिए किया जाता है. इसके लिए, उपयोगकर्ता को खाते में साइन इन करना ज़रूरी है.

Nest Aware की ज़रूरत है. अगर इवेंट यूआरएल की समयसीमा खत्म हो गई है या डिवाइस की सदस्यता चालू नहीं है, तो यह वैल्यू पेलोड में शामिल नहीं की जाती.

यूआरएल की समयसीमा खत्म होने के समय के बारे में जानकारी के लिए, last_event/urls_expire_time देखें.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_event/web_url
लौटाए गए सामानstring
उदाहरण: &quat;https://home.nest.com/cameras/device_id/cuepoints/string?auth=camera_token&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

app_url (ऐप्लिकेशन_का_यूआरएल)

Nest ऐप्लिकेशन का यूआरएल (डीप लिंक), पिछली आवाज़ या मोशन इवेंट पर. इसका इस्तेमाल आखिरी बार रिकॉर्ड किए गए इवेंट को दिखाने के लिए किया जाता है. इसके लिए, उपयोगकर्ता को खाते में साइन इन करना ज़रूरी है.

Nest Aware की ज़रूरत है. अगर इवेंट यूआरएल की समयसीमा खत्म हो गई है या डिवाइस की सदस्यता चालू नहीं है, तो यह वैल्यू पेलोड में शामिल नहीं की जाती.

यूआरएल की समयसीमा खत्म होने के समय के बारे में जानकारी के लिए, last_event/urls_expire_time देखें.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_event/app_url
लौटाए गए सामानstring
उदाहरण: &quat;nestmobile://cameras/device_id/cuepoints/string?auth=camera_token&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड / v1-v3
कैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट / v1-v3
कैमरा रीड/राइट + इमेज / v1-v4

image_url (इमेज_का_यूआरएल)

आवाज़ या मोशन इवेंट के लिए कैप्चर की गई इमेज फ़ाइल का यूआरएल (लिंक).

Nest Aware की ज़रूरत है. यूआरएल की समयसीमा खत्म होने के समय की जानकारी के लिए, last_event/urls_expire_time देखें.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_event/image_url
लौटाए गए सामानstring
उदाहरण: &कोटेशन;https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट + इमेज / v1-v4

ऐनिमेट किया गया_image_url

आवाज़ या मोशन इवेंट के लिए कैप्चर की गई gif फ़ाइल का यूआरएल (लिंक).

Nest Aware की ज़रूरत है.

ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_event/animated_image_url
लौटाए गए सामानstring
उदाहरण: &कोटेशन;https://www.dropcam.com/api/wwn.get_image/string1/device_id/string2?auth=camera_token&कोटेशन;
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड + इमेज / v1-v4
कैमरा रीड/राइट + इमेज / v1-v4

activity_zone_ids

मोशन इवेंट का पता लगाने वाले ऐक्टिविटी ज़ोन के आइडेंटिफ़ायर.

Nest Aware की ज़रूरत है. activity_zones अरे के साथ इस्तेमाल किए जाने पर, आप इन आईडी से ज़ोन का नाम पा सकते हैं.

अगर last_event/has_motion

  • true = मोशन इवेंट का पता लगाने वाले ऐक्टिविटी ज़ोन के आईडी दिखाता है
  • false = खाली श्रेणी देता है
ब्यौरा
https://developer-api.nest.com/devices/cameras/device_id/last_event/activity_zone_ids
लौटाए गए सामानarray
उदाहरण: [ string1, string2,... ]
ऐक्सेस करनासिर्फ़ पढ़ने के लिए
इसमें उपलब्ध हैकैमरा रीड + इमेज / v3-v4
कैमरा रीड/राइट + इमेज / v3-v4