उपयोगकर्ता और शुल्क की सीमाएं

Device Access प्रोजेक्ट, उपयोगकर्ता, स्ट्रक्चर, और दर की सीमाओं के हिसाब से प्रतिबंधित हैं. ये इस बात पर निर्भर करते हैं कि व्यावसायिक ऑफ़र किस तरह का है और माहौल में है.

हम चाहते हैं कि डेवलपर, उपयोगकर्ताओं को बेहतरीन अनुभव दें. साथ ही, हम यह भी चाहते हैं कि उपयोगकर्ता के लिए Nest की सेवा और डिवाइस हमेशा उपलब्ध रहें. किसी तय समयावधि में बड़ी संख्या में अनुरोध करने वाले इंटिग्रेशन से, सेवा और डिवाइस की उपलब्धता पर असर पड़ सकता है. इसलिए, SDM API अनुरोध करने की दर की सीमाएं लागू करता है. दर को सीमित करने से, किसी दी गई समयावधि में एपीआई कॉल की संख्या सीमित हो जाती है. साथ ही, संसाधनों का ज़रूरत से ज़्यादा इस्तेमाल भी नहीं किया जा सकता.

एनवायरमेंट के हिसाब से सीमाएं

सभी प्रोजेक्ट,   सैंडबॉक्स   एनवायरमेंट में शुरू होते हैं. सैंडबॉक्स का मकसद, एसडीएम एपीआई का आकलन और निजी इस्तेमाल का आकलन करना है. इसलिए, इसकी सीमा भी तय की जाती है. ज़्यादा उपयोगकर्ता आधार वाले एनवायरमेंट की अलग-अलग सीमाएं होती हैं. जैसे,   कमर्शियल डेवलपमेंट  .

सैंडबॉक्स उपयोगकर्ता सीमाएं

सैंडबॉक्स में, सभी प्रोजेक्ट के पांच स्ट्रक्चर के लिए, 25 उपयोगकर्ताओं को जोड़ा जा सकता है. एक खाते के लिए, ज़्यादा से ज़्यादा तीन प्रोजेक्ट जोड़े जा सकते हैं.

हर स्ट्रक्चर में ज़्यादा से ज़्यादा पांच उपयोगकर्ता जोड़े जा सकते हैं. इसलिए, सभी पांच स्ट्रक्चर की सीमा पूरी होने के बाद ही 5 उपयोगकर्ता इस्तेमाल किए जा सकेंगे. किसी स्ट्रक्चर के लिए पांच लोगों को इस्तेमाल करने की सीमा में, डेवलपर खाते को ही शामिल नहीं किया जाता. इस डेवलपर खाते को प्रोजेक्ट का मालिकाना हक दिया जाता है.

वहीं, अगर किसी प्रोजेक्ट में पांच से ज़्यादा स्ट्रक्चर वाले 15 उपयोगकर्ता हैं, तो और उपयोगकर्ता सिर्फ़ मौजूदा पांच स्ट्रक्चर में जोड़े जा सकते हैं, क्योंकि स्ट्रक्चर की सीमा पहले ही पूरी हो चुकी है.

सैंडबॉक्स दर की सीमाएं

सैंडबॉक्स की दर तीन अलग-अलग लेवल पर सीमित है. जब तक अलग से न बताया जाए, तब तक क्वेरी के लिए हर मिनट (क्यूपीएम) के हिसाब से यह सीमा तय की जाती है.

API स्तर

हर प्रोजेक्ट के लिए, हर उपयोगकर्ता के लिए एपीआई कॉल सीमित होते हैं. अलग-अलग तरीकों की ज़्यादा जानकारी के लिए, एपीआई रेफ़रंस देखें.

एपीआई का तरीका	दर की सीमा
devices.executeCommand	10 क्यूपीएम
devices.get	10 क्यूपीएम
devices.list	5 क्यूपीएम
structures.get	5 क्यूपीएम
structures.list	5 क्यूपीएम
structures.rooms.get	5 क्यूपीएम
structures.rooms.list	5 क्यूपीएम

कमांड लेवल

हर Trait निर्देश (devices.executeCommand), हर प्रोजेक्ट के लिए, हर उपयोगकर्ता के लिए, हर डिवाइस के लिए पांच क्यूपीएम तक सीमित है.

इसका मतलब है कि अगर किसी प्रोजेक्ट में दो उपयोगकर्ता हैं, जिनमें से हर एक में दो डिवाइस (कुल चार डिवाइस) हैं, तो उन चारों डिवाइसों में से हर डिवाइस के लिए, एक ही निर्देश को एक मिनट में पांच बार कॉल किया जा सकता है.

हालांकि, अगर किसी प्रोजेक्ट में दो उपयोगकर्ता हैं और कुल छह डिवाइसों में से हर एक में तीन डिवाइस हैं, तो उन छह डिवाइसों में से हर डिवाइस के लिए, एक मिनट में पांच बार एक ही निर्देश नहीं भेजा जा सकता. इसका नतीजा यह होगा कि हर उपयोगकर्ता के लिए 15 क्यूपीएम, जबकि प्रोजेक्ट के उपयोगकर्ता के लिए devices.executeCommand एपीआई लेवल की दर की सीमा 10 क्यूपीएम होगी.

डिवाइस इंस्टेंस लेवल

इसके अलावा, डिवाइस की बैटरी सुरक्षा के लिए, सभी प्रोजेक्ट और कमांड (devices.executeCommand) में डिवाइस के इंस्टेंस लेवल की सीमाएं लागू की जाती हैं. ये सीमाएं, QPM और क्वेरी प्रति घंटे (QPH) दोनों लेवल पर लागू होती हैं. ये get और list एपीआई तरीकों पर लागू नहीं होतीं.

उदाहरण के लिए, मान लीजिए कि प्रोजेक्ट A और प्रोजेक्ट B, दोनों के पास एक ही डिवाइस का ऐक्सेस है (शायद उपयोगकर्ता ने एक ही डिवाइस का इस्तेमाल करने वाले दो अलग-अलग व्यावसायिक इंटिग्रेशन को अनुमति दी है). अगर प्रोजेक्ट A ने एक मिनट के अंदर डिवाइस A को 4 निर्देश भेजे हैं, तो प्रोजेक्ट B डिवाइस A को उसी मिनट में सिर्फ़ एक निर्देश भेज सकता है. इस स्थिति में, दोनों प्रोजेक्ट से डिवाइस A को दिए जाने वाले निर्देश, डिवाइस A को दिए गए पहले निर्देश से शुरू होने वाले मिनट के आखिर तक रोक दिए जाते हैं.

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

डिवाइस का टाइप	डिवाइस इंस्टेंस रेट की सीमा
थर्मोस्टैट	5 क्यूपीएम या 100 क्यूपीएच
कैमरा	30 क्यूपीएम या 100 क्यूपीएच
दरवाज़े की घंटी	30 क्यूपीएम या 100 क्यूपीएच

गड़बड़ियां

इस गाइड के संबंध में, ये गड़बड़ी कोड दिख सकते हैं:

गड़बड़ी संदेश	RPC	समस्या हल करना
दर सीमित है.	RESOURCE_EXHAUSTED	हर डेवलपर के लिए एक कोटा होता है, जिसमें यह तय किया जाता है कि उन्हें कितने कॉल करने हैं. अगर आपने कोटा से ज़्यादा कॉल किए, तो आपको 'सीमित दर की जानकारी' का मैसेज मिलेगा. इसे ठीक करने के लिए, कोटा खत्म होने के बाद कॉल को फिर से सबमिट करें.

एपीआई के गड़बड़ी कोड की पूरी सूची देखने के लिए, एपीआई के गड़बड़ी कोड का रेफ़रंस देखें.