कैमरा एपीआई

नेस्ट एपीआई सभी नेस्ट कैम ™ मॉडल के साथ काम करता है।

उपयोगकर्ता devices/cameras समूह में अधिकतम नेस्ट कैम जोड़ सकते हैं, अधिकतम संरचना तक । जब आप इस डेटा स्थान पर कॉल करते हैं, तो आप नेस्ट कैम डेटा (संरचना में उपकरणों के लिए डेटा मान) तक पहुंच सकते हैं।

JSON दस्तावेज़ में प्रत्येक devices/cameras/ device_id के नीचे सभी मान पाए जाते हैं।

डिवाइस आईडी

नेस्ट कैम अद्वितीय पहचानकर्ता।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /device_id
रिटर्न	string उदाहरण: "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

structure_id

अद्वितीय पहचानकर्ता संरचना।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /structure_id
रिटर्न	string उदाहरण: "VqFabWH21nw ..."
पहुंच	सिफ़ पढ़िये
में उपलब्ध	कैमरा रीड / v1-v3 कैमरा पढ़ा + चित्र / v1-v4 कैमरा रीड / राइट / v1-v3 कैमरा पढ़ने / लिखने + चित्र / v1-v4

where_id

एक अद्वितीय, नेस्ट जनित पहचानकर्ता जो name प्रतिनिधित्व करता है, डिवाइस का प्रदर्शन नाम।

नेस्ट थर्मोस्टैट्स , नेस्ट प्रोटेक्ट्स और नेस्ट कैम के लिए नाम के बारे में और जानें।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /where_id
रिटर्न	string उदाहरण: "d6reb_OZTM ..."
पहुंच	सिफ़ पढ़िये
में उपलब्ध	कैमरा रीड / v1-v3 कैमरा पढ़ा + चित्र / v1-v4 कैमरा रीड / राइट / v1-v3 कैमरा पढ़ने / लिखने + चित्र / v1-v4

where_name

डिवाइस का प्रदर्शन नाम। नेस्ट कैम के साथ where_id हमारे द्वारा प्रदान की जाने वाली सूची या कस्टम नाम से कोई भी कमरा नाम हो सकता है। नेस्ट थर्मोस्टैट्स , नेस्ट प्रोटेक्ट्स और नेस्ट कैम के लिए नाम के बारे में और जानें।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /where_name
रिटर्न	string उदाहरण: "दालान"
पहुंच	सिफ़ पढ़िये
में उपलब्ध	कैमरा पढ़ा / v3 कैमरा रीड + इमेज / v4 कैमरा रीड / राइट / v3 कैमरा पढ़ने / लिखने + चित्र / v4

नाम

डिवाइस का प्रदर्शन नाम; हमारे द्वारा प्रदान की गई सूची, या कस्टम नाम से किसी भी कमरे का नाम हो सकता है।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /name
रिटर्न	string उदाहरण: "दालान"
पहुंच	सिफ़ पढ़िये
में उपलब्ध	कैमरा रीड / v1-v3 कैमरा पढ़ा + चित्र / v1-v4 कैमरा रीड / राइट / v1-v3 कैमरा पढ़ने / लिखने + चित्र / v1-v4

NAME_LONG

डिवाइस का लंबा प्रदर्शन नाम। एक कस्टम (लेबल) शामिल है, जो उपयोगकर्ता द्वारा या wheres माध्यम से बनाया गया है।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /name_long
रिटर्न	string उदाहरण: "हॉलवे नेस्ट कैम (ऊपर)"
पहुंच	सिफ़ पढ़िये
में उपलब्ध	कैमरा रीड / v1-v3 कैमरा पढ़ा + चित्र / v1-v4 कैमरा रीड / राइट / v1-v3 कैमरा पढ़ने / लिखने + चित्र / v1-v4

ऑनलाइन है

नेस्ट सेवा के साथ डिवाइस कनेक्शन की स्थिति।

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

is_streaming

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

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

is_audio_input_enabled

कैमरा माइक्रोफोन की स्थिति, या तो और सुनने, या बंद पर। नेस्ट कैम ऑडियो सेटिंग्स के बारे में अधिक जानें।

विवरण
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

टाइमस्टैम्प जो आईएसओ 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

नेस्ट अवेयर सदस्यता की स्थिति (सदस्यता सक्रिय या नहीं)।

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

web_url

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

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /web_url
रिटर्न	string उदाहरण: " https://home.nest.com/cameras/ device_id ?auth= camera_token "
पहुंच	सिफ़ पढ़िये
में उपलब्ध	कैमरा रीड / v1-v3 कैमरा पढ़ा + चित्र / v1-v4 कैमरा रीड / राइट / v1-v3 कैमरा पढ़ने / लिखने + चित्र / v1-v4

APP_URL

नेस्ट ऐप में लाइव वीडियो स्ट्रीम के लिए ऐप URL (गहरा लिंक)।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /app_url
रिटर्न	string उदाहरण: " 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

सभी परिभाषित गतिविधि क्षेत्रों की एक सरणी देता है।

गतिविधि ज़ोन का उपयोग वीडियो स्ट्रीम के उपयोगकर्ता-परिभाषित क्षेत्रों के भीतर गति की घटनाओं की निगरानी के लिए किया जाता है। नेस्ट अवेयर की आवश्यकता है।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /activity_zones
रिटर्न	array उदाहरण: [ {"name" : " string1 ", "id" : " string2 "},... ] • string1 क्षेत्र नाम है, या तो उपयोगकर्ता द्वारा परिभाषित या स्वचालित रूप से उत्पन्न जब क्षेत्र बनाया जाता है। string2 एक पहचानकर्ता है जो नेस्ट द्वारा सौंपा गया है जब गतिविधि क्षेत्र बनाया जाता है।
पहुंच	सिफ़ पढ़िये
में उपलब्ध	कैमरा रीड + इमेज / v3-v4 कैमरा पढ़ने / लिखने + चित्र / v3-v4

public_share_url

जब कोई उपयोगकर्ता अपनी वीडियो स्ट्रीम को सार्वजनिक करता है, तो आप इस URL तक पहुँच सकते हैं।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /public_share_url
रिटर्न	string उदाहरण: " https://video.nest.com/live/ string1 ? string2 " string1 वीडियो स्ट्रीम नाम है, या तो उपयोगकर्ता द्वारा परिभाषित या स्वचालित रूप से जनरेट किया जाता है जब स्ट्रीम को सार्वजनिक पर सेट किया जाता है।
पहुंच	सिफ़ पढ़िये
में उपलब्ध	कैमरा रीड + इमेज / v3-v4 कैमरा पढ़ने / लिखने + चित्र / v3-v4

SNAPSHOT_URL

मांग पर एक छवि कैप्चर करें। लाइव वीडियो स्ट्रीम से कैप्चर की गई छवि का URL लौटाता है। आवश्यकता है कि कैमरा चालू हो और सक्रिय रूप से स्ट्रीमिंग हो।

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

• snapshot_url - लाइव वीडियो स्ट्रीम से कैप्चर की गई छवि का URL लौटाता है
• आवश्यकता है कि कैमरा चालू हो और सक्रिय रूप से स्ट्रीमिंग हो

यदि आप हैं तो API से स्नैपशॉट की गुणवत्ता केवल 1080p थ्रूपुट है:

• एप्लिकेशन में वेब स्ट्रीम को सक्रिय रूप से देखना ( web_url )
• सार्वजनिक स्ट्रीम को सक्रिय रूप से देखना ( app_url )
• नेस्ट अवेयर की सदस्यता ली

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

नेस्ट कैमरा के लिए बैंडविड्थ आवश्यकताओं के बारे में अधिक जानें।

नेस्ट अवेयर सब्सक्रिप्शन स्टेटस के आधार पर इस कॉल पर रेट लिमिट लागू होती है।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /snapshot_url
रिटर्न	string उदाहरण: " string1 / device_id / string2 ?auth= camera_token "
पहुंच	सिफ़ पढ़िये
में उपलब्ध	कैमरा रीड + इमेज / v3-v4 कैमरा पढ़ने / लिखने + चित्र / v3-v4

अंतिम कार्यक्रम

यह ऑब्जेक्ट अंतिम घटना के बारे में जानकारी प्राप्त करता है जिसने एक अधिसूचना को ट्रिगर किया।

कुछ फ़ील्ड और कुछ अनुमति संयोजनों को अंतिम ईवेंट जानकारी तक पहुंचने के लिए नेस्ट अवेयर सदस्यता की आवश्यकता होती है।

JSON दस्तावेज़ में प्रत्येक devices/cameras/ device_id /last_event के नीचे सभी मान पाए जाते हैं।

has_sound

ध्वनि घटना - ध्वनि का पता चला था।

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

has_motion

गति घटना - गति का पता चला था।

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

has_person

व्यक्ति घटना - एक व्यक्ति का पता चला था।

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

समय शुरू

इवेंट प्रारंभ समय, आईएसओ 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

अंतिम समय

आईएसओ 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

टाइमस्टैम्प, आईएसओ 8601 प्रारूप में, जो इन घटनाओं से संबंधित URL की समाप्ति की पहचान करता है:

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

समाप्ति समय की गणना इस प्रकार की जाती है: नेस्ट अवेयर सब्सक्रिप्शन प्लान के आधार पर last_event/start_time + n दिन (जहां n = 10 या 30 दिन)।

नेस्ट अवेयर की आवश्यकता है।

विवरण
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

Web.nest.com पर अंतिम ध्वनि या गति घटना के लिए वेब URL (गहरा लिंक)। अंतिम दर्ज की गई घटना को प्रदर्शित करने के लिए उपयोग किया जाता है, और उपयोगकर्ता को खाते में प्रवेश करने की आवश्यकता होती है।

नेस्ट अवेयर की आवश्यकता है। यदि ईवेंट URL की समय सीमा समाप्त हो गई है या डिवाइस में सक्रिय सदस्यता नहीं है, तो यह मूल्य पेलोड में शामिल नहीं है।

इस URL की समाप्ति समय की जानकारी के लिए last_event/urls_expire_time देखें।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /last_event/web_url
रिटर्न	string उदाहरण: " https://home.nest.com/cameras/ device_id /cuepoints/ string ?auth= camera_token "
पहुंच	सिफ़ पढ़िये
में उपलब्ध	कैमरा रीड / v1-v3 कैमरा पढ़ा + चित्र / v1-v4 कैमरा रीड / राइट / v1-v3 कैमरा पढ़ने / लिखने + चित्र / v1-v4

APP_URL

नेस्ट ऐप यूआरएल (गहरा लिंक) अंतिम ध्वनि या गति घटना के लिए। अंतिम दर्ज की गई घटना को प्रदर्शित करने के लिए उपयोग किया जाता है, और उपयोगकर्ता को खाते में प्रवेश करने की आवश्यकता होती है।

नेस्ट अवेयर की आवश्यकता है। यदि ईवेंट URL की समय सीमा समाप्त हो गई है या डिवाइस में सक्रिय सदस्यता नहीं है, तो यह मूल्य पेलोड में शामिल नहीं है।

इस URL की समाप्ति समय की जानकारी के लिए last_event/urls_expire_time देखें।

विवरण
https://developer-api.nest.com/devices/cameras/ device_id /last_event/app_url
रिटर्न	string उदाहरण: " nestmobile://cameras/ device_id /cuepoints/ string ?auth= camera_token "
पहुंच	सिफ़ पढ़िये
में उपलब्ध	कैमरा रीड / v1-v3 कैमरा पढ़ा + चित्र / v1-v4 कैमरा रीड / राइट / v1-v3 कैमरा पढ़ने / लिखने + चित्र / v1-v4

छवि यूआरएल

ध्वनि या गति घटना के लिए कैप्चर की गई छवि फ़ाइल का URL (लिंक)।

नेस्ट अवेयर की आवश्यकता है। इस URL की समाप्ति समय की जानकारी के लिए 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

animated_image_url

ध्वनि या गति की घटना के लिए कैप्चर की गई gif फ़ाइल का URL (लिंक)।

नेस्ट अवेयर की आवश्यकता है।

विवरण
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

गतिविधि क्षेत्रों के लिए पहचानकर्ता जिन्होंने एक गति घटना का पता लगाया।

नेस्ट अवेयर की आवश्यकता है। जब 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