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

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

डिवाइस जोड़ना

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

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

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

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

ज़्यादा जानकारी और उदाहरण के लिए, 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 के साथ डिवाइस बनाने की कोशिश की है जो पहले से मौजूद है.

अगले चरण