डिवाइस बनाना और उन्हें मैनेज करना

इस गाइड में, डिवाइस बनाने, उन्हें मैनेज करने, और मिटाने का तरीका बताया गया है. डिवाइस को सही तरीके से मैनेज करने से, उपयोगकर्ता को बेहतर अनुभव मिलता है. साथ ही, Ambient API का बेहतर तरीके से इस्तेमाल किया जा सकता है.

डिवाइस बनाना

जब कोई उपयोगकर्ता टीवी और सीमित इनपुट वाले डिवाइस के ऐप्लिकेशन के लिए OAuth 2.0 फ़्लो का इस्तेमाल करके पुष्टि कर ले, तो उसके Google Photos खाते में डिवाइस जोड़ें.

जब आपका ऐप्लिकेशन devices.create तरीके का इस्तेमाल करके डिवाइस बनाता है, तो Ambient API एक AmbientDevice ऑब्जेक्ट दिखाता है. इसमें Google से जनरेट किया गया id शामिल होता है. इस id को सुरक्षित तरीके से सेव करें और इसे अपने उपयोगकर्ताओं से जोड़ें.

OAuth की मदद से डिवाइस बनाने की प्रोसेस को आसान बनाना

Ambient API, OAuth फ़्लो को आसान बनाता है. इसकी मदद से, उपयोगकर्ता की पुष्टि के साथ-साथ डिवाइस भी बनाया जा सकता है. अपने शुरुआती OAuth अनुरोध में अतिरिक्त state पैरामीटर पास करके, डिवाइस बनाने की प्रोसेस को सीधे तौर पर उपयोगकर्ता के साइन-इन फ़्लो से लिंक किया जा सकता है. इससे, उपयोगकर्ता को स्कैन करने के लिए ज़रूरी क्यूआर कोड की संख्या कम हो जाती है और उपयोगकर्ता अनुभव को आसान बनाया जा सकता है.

ज़्यादा जानकारी और उदाहरण के लिए, Ambient API के लिए पुष्टि करने का आसान तरीका गाइड देखें.

डिवाइस की सीमाएं

आपका ऐप्लिकेशन, हर उपयोगकर्ता के लिए 100 डिवाइस तक बना सकता है. इस सीमा से ज़्यादा अनुरोध करने पर, एपीआई RESOURCE_EXHAUSTED गड़बड़ी का मैसेज दिखाता है.

डिवाइस मैनेज करें

डिवाइस बनाने और उसे उपयोगकर्ता के Google Photos खाते से लिंक करने के बाद, आपको उसका लाइफ़साइकल मैनेज करना पड़ सकता है.

डिवाइसों को वापस पाना

किसी खास डिवाइस के बारे में जानकारी पाने के लिए, उसके यूनीक id के साथ devices.get तरीके का इस्तेमाल करें. यह डिवाइस की स्थिति देखने के लिए काम आता है. जैसे, mediaSourcesSet सही है या नहीं.

डिवाइसों को अपडेट करना

devices.patch तरीके का इस्तेमाल करके, किसी मौजूदा डिवाइस की कुछ प्रॉपर्टी अपडेट की जा सकती हैं. जैसे, डिसप्ले का नाम. इससे उपयोगकर्ता अपने डिवाइसों को अपनी पसंद के मुताबिक बना सकते हैं. साथ ही, Google Photos में उन्हें आसानी से पहचाना जा सकता है.

डिवाइस हटाएं

डिवाइसों को मिटाने के लिए कोई रणनीति लागू करें, ताकि डेटा को सही तरीके से मिटाया जा सके और उपयोगकर्ता उसे कंट्रोल कर सके. devices.delete तरीके का इस्तेमाल करके, किसी डिवाइस को मिटाया जा सकता है.

डिवाइसों को मिटाने के लिए, इन स्थितियों पर ध्यान दें:

  • उपयोगकर्ता का डिसकनेक्ट होना: अगर कोई उपयोगकर्ता आपके ऐप्लिकेशन को अपने Google Photos खाते से डिसकनेक्ट करता है, तो आपको उससे जुड़े डिवाइस को मिटा देना चाहिए.
  • अनाथ डिवाइस: अगर आपके पास किसी id का ट्रैक नहीं है, लेकिन आपके पास requestId है जिसका इस्तेमाल डिवाइस बनाने के दौरान किया गया था, तो अनाथ डिवाइस को हटाने के लिए, requestId के साथ devices.delete का इस्तेमाल किया जा सकता है. इससे, उपयोगकर्ता के खाते में डुप्लीकेट कॉन्टेंट अपने-आप बनने से रोका जा सकता है.

ज़रूरी बातें और सबसे सही तरीके

  • डिवाइस का लाइफ़साइकल और उपयोगकर्ता की अनुमति: आपको डिवाइसों और उपयोगकर्ता की अनुमति देने वाले टोकन के लाइफ़साइकल को मैनेज करना होगा. यह तय करें कि डिवाइस कितने समय तक ऐक्टिव रहेंगे. साथ ही, यह भी तय करें कि अगर कोई डिवाइस ऐक्टिव नहीं रहता या उसका टोकन खत्म हो जाता है, तो टोकन रीफ़्रेश करने या फिर से अनुमति देने की प्रोसेस कैसे मैनेज की जाएगी.
  • गड़बड़ी को मैनेज करना: डिवाइस से जुड़े सभी एपीआई कॉल के लिए, गड़बड़ी को मैनेज करने की बेहतर सुविधा लागू करें. इन स्थितियों के लिए तैयार रहें:
    • NOT_FOUND: अगर कोई डिवाइस मौजूद नहीं है या उसका मालिकाना हक उपयोगकर्ता के पास नहीं है.
    • RESOURCE_EXHAUSTED: डिवाइस की तय सीमा से ज़्यादा डाउनलोड करने पर.
    • ALREADY_EXISTS: अगर किसी ऐसे requestId के साथ डिवाइस बनाने की कोशिश की जाती है जो पहले से मौजूद है.

अगले चरण