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