सेशन बनाना और उन्हें मैनेज करना

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

शुरू करने से पहले

• अपना ऐप्लिकेशन कॉन्फ़िगर करना: एपीआई चालू करें और पुष्टि करने की सुविधा सेट अप करें. यहां जाएं: ज़्यादा जानकारी के लिए अपने ऐप्लिकेशन को कॉन्फ़िगर करें चरण पूरे करें.
• फ़्लो को समझना: पिकर एपीआई का इस्तेमाल शुरू करना की समीक्षा करें फ़ोटो चुनने की पूरी प्रोसेस के बारे में ज़्यादा जानें.
• अनुमति के ज़रूरी दायरों की समीक्षा करना: सेशन के साथ काम करने के लिए, photospicker.mediaitems.readonly दायरा. स्कोप के बारे में ज़्यादा जानकारी के लिए, अनुमति के दायरे देखें.

सेशन का लाइफ़साइकल

पिकर एपीआई की मदद से, जानकारी हासिल करने, उसे हासिल करने, और सत्र हटाएं. उपयोगकर्ताओं की पुष्टि करने के बाद, फ़ोटो चुनने के लाइफ़साइकल को मैनेज करने के लिए सेशन का इस्तेमाल किया जा सकता है.

1. उपयोगकर्ता को मीडिया आइटम चुनने की सुविधा देने के लिए, सेशन बनाएं.
2. सेशन पोल की मदद से देखें कि उपयोगकर्ता ने कब ने मीडिया आइटम को चुनने का काम पूरा कर लिया.
3. मीडिया आइटम की सूची बनाएं और उन्हें वापस लाएं.
4. सेशन को मिटाकर, उसे मिटाएं.

सेशन बनाना

एक सत्र बनाएं, ताकि आपके उपयोगकर्ता सीधे अपनी Google Photos ऐप्लिकेशन खोलें और उन्हें अपने ऐप्लिकेशन में वापस शेयर करें.

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

सत्र की सीमाएं

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

पोल और सेशन को मॉनिटर करना

सेशन बनाने के बाद, समय-समय पर sessions.get एंडपॉइंट पर पोल करें, ताकि आपको किसी सेशन की मौजूदा स्थिति. रिस्पॉन्स में mediaItemsSet प्रॉपर्टी दिखती है उपयोगकर्ता के चुने जाने के बाद, true.

पक्का करें कि आपने बेहतर पोलिंग का इस्तेमाल किया हो. sessions.get रिस्पॉन्स में यह शामिल होता है pollingConfig ऑब्जेक्ट. ग़ैर-ज़रूरी चीज़ों से बचने के लिए, नीचे दिए गए फ़ील्ड का इस्तेमाल करें इन सभी कामों के लिए एक शानदार उपयोगकर्ता अनुभव दिया जा सकता है:

• pollInterval: पोलिंग के लिए सबसे सही इंटरवल
• timeoutIn: टाइम आउट की अवधि

ज़्यादा जानकारी के लिए, पोलिंग फ़्लो का उदाहरण देखें.

सेशन मिटाना और उन्हें खाली करना

sessions.delete किसी सेशन को हटा देता है. आम तौर पर, इसका इस्तेमाल उपयोगकर्ता के बाद क्लीनअप करने के लिए किया जाता है मीडिया को चुनने या सत्र का समय खत्म होने पर उसे पूरा कर चुका हो.

सबसे सही तरीका यह है कि उपयोगकर्ता के मीडिया आइटम चुनने के बाद, सेशन को मिटा दें और आपके ऐप्लिकेशन ने मीडिया आइटम को वापस पा लिया है बाइट.

पोलिंग फ़्लो का उदाहरण

यह कोई सेशन बनाने और उसके लिए पोल करने का एक उदाहरण है. पहली बार पुष्टि करने के बाद आपका उपयोगकर्ता, नया सत्र बनाएं.

1. सेशन बनाएं: नया सेशन शुरू करने के लिए, sessions.create पर कॉल करें और pickerUri पाएं.
2. उपयोगकर्ता को pickerUri प्रज़ेंट करें: यूआरएल दिखाएं या क्यूआर कोड जनरेट करें स्कैन करने के लिए कोड.
3. सेशन को पोल करें:
   1. pollingConfig के सुझाए गए पोल इंटरवल का इस्तेमाल करें.
   2. देखें कि mediaItemsSet सही है या नहीं.
      1. अगर true है, तो चुने गए मीडिया आइटम की सूची बनाएं.
      2. अगर false, तो timeoutIn पहुंचने तक पोलिंग जारी रखें.
   3. टाइम आउट और रद्द करने की प्रोसेस आसानी से मैनेज करें.

GET https://photoslibrary.googleapis.com/v1/sessions/{sessionId}

यहां जवाब का एक उदाहरण दिया गया है:

{
  "id": string,
  "pickerUri": string,
  "pollingConfig": {
    object (PollingConfig)
  },
  "mediaItemsSet": boolean
}

उपयोगकर्ता को pickerUri प्रज़ेंट करें. इसके बाद, सेशन का पोल शुरू करें.

इसके लिए जवाब देखें:

• mediaItemsSet: अगर उपयोगकर्ता, मीडिया आइटम चुन लेता है, तो सही होता है
• pollingConfig.pollInterval: इंतज़ार का समय सुझाया गया है अगले पोल से पहले
• pollingConfig.timeoutIn: पहले से इंतज़ार करने का कुल समय समय खत्म

अगर mediaItemsSet गलत है और timeoutIn तक नहीं पहुंचा है, तो pollInterval के लिए इंतज़ार करें और फिर से पोल करें.

अगर mediaItemsSet सही है, तो चुने गए मीडिया आइटम की सूची बनाएं.

अगर आपने timeoutIn तक पहुंच हासिल कर ली है, तो टाइम आउट को अच्छी तरह मैनेज करें.