सिस्टम की स्थिरता और परफ़ॉर्मेंस को बेहतर बनाए रखने के लिए, Health Connect, Health Connect API से क्लाइंट कनेक्शन पर दर सीमाएं लागू करता है.
इस गाइड में, Health Connect में एपीआई के ज़रिए डेटा को पढ़ने और सेव करने से जुड़ी कार्रवाइयों पर लगाई गई सीमाओं के बारे में बताया गया है. साथ ही, इसमें यह भी बताया गया है कि ऐप्लिकेशन को बेहतर तरीके से डिज़ाइन करके, दर की सीमा को कैसे कम किया जा सकता है.
एपीआई से जुड़ी सीमाएं
एपीआई के फ़ोरग्राउंड और बैकग्राउंड, दोनों तरह के ऑपरेशन के लिए अनुरोध की दर के तय कोटे लागू किए जाते हैं.
आपके ऐप्लिकेशन के टाइप और फ़ोरग्राउंड या बैकग्राउंड में किए जा रहे ऑपरेशन के आधार पर, दर और मेमोरी की सीमाएं अलग-अलग होती हैं.
पढ़ने और बदलाव करने की सीमाएं
Health Connect में मौजूद डेटा को पढ़ने और बदलाव के लॉग की सीमाओं के लिए, Health Connect आपके ऐप्लिकेशन के लिए उपलब्ध एपीआई कॉल की संख्या पर दो सीमाएं लगाता है:
- एपीआई कॉल की संख्या पर समय-समय पर लगने वाली पाबंदी. इससे यह तय होता है कि आपका ऐप्लिकेशन, एपीआई को कितने कॉल कर सकता है.
- आपका ऐप्लिकेशन, हर दिन एपीआई कॉल की एक तय संख्या तक ही अनुरोध कर सकता है.
सीमाएं डालना, अपडेट करना, और मिटाना
Health Connect में, डेटा डालने, अपडेट करने, और मिटाने से जुड़ी चार अलग-अलग सीमाएं तय की गई हैं:
- आपके ऐप्लिकेशन से एपीआई को किए जा सकने वाले कॉल की संख्या पर समय-समय पर लगने वाली सीमा.
- एपीआई को आपके ऐप्लिकेशन से हर दिन किए जा सकने वाले कॉल की संख्या की सीमा.
- एक साथ कई आइटम डालने के लिए मेमोरी की सीमा.
- एक बार में रिकॉर्ड डालने की सीमा.
सबसे सही तरीके
हमारा सुझाव है कि ऐप्लिकेशन, Health Connect API के साथ इस तरह इंटरैक्ट करें कि बैटरी का इस्तेमाल कम से कम हो, सिस्टम की परफ़ॉर्मेंस बेहतर बनी रहे, और सभी CRUD ऑपरेशनों में डेटा को बेहतर तरीके से मैनेज किया जा सके.
यहां कुछ सबसे सही तरीकों के बारे में बताया गया है.
बैकग्राउंड में किए गए एपीआई कॉल
बैकग्राउंड में होने वाली कार्रवाइयों के लिए बैटरी के इस्तेमाल से, उपयोगकर्ता अनुभव कम हो जाता है. साथ ही, डेटा की निजता के बारे में सवाल उठते हैं.
इसलिए, बैकग्राउंड में दर सीमित करने की सुविधा, फ़ोरग्राउंड में दर सीमित करने की सुविधा से ज़्यादा सख्त होती है. इसलिए, यह ज़रूरी है कि आपका ऐप्लिकेशन बैकग्राउंड में एपीआई कॉल की संख्या को सीमित करे.
अपवाद मैनेज करना
अगर आपका ऐप्लिकेशन, Health Connect में डेटा सेव करते समय किसी समस्या का सामना करता है, तो हमारा सुझाव है कि आप उस जगह से फिर से कोशिश करें जहां समस्या हुई थी.
सिर्फ़ उस डेटा को न मिटाएं जिसके बारे में सवाल पूछा गया है. साथ ही, डेटा सेव करने के पूरे अनुरोध को फिर से न भेजें. इस तरीके से, आपके इंसर्ट कोटे का इस्तेमाल होता है, परफ़ॉर्मेंस कम हो जाती है, और बैटरी लाइफ़ पर बुरा असर पड़ता है.
बदलाव लॉग को मैनेज करना
आपके ऐप्लिकेशन के लिए, दर की सीमा तय किए जाने के जोखिम को कम करने के लिए, आपको बदलाव के लॉग को मैनेज करने की सुविधा का इस्तेमाल करना चाहिए. इससे, Health Connect से मिले डेटा के साथ अपने डेटाबेस को सिंक किया जा सकता है. इसके बजाय, आपको रॉ डेटा को पढ़ने के अनुरोधों पर ज़्यादा भरोसा नहीं करना चाहिए.