पिकर एपीआई का इस्तेमाल शुरू करना

Picker API, उपयोगकर्ताओं को Google Photos लाइब्रेरी से फ़ोटो और वीडियो चुनने और उन्हें आपके ऐप्लिकेशन के साथ शेयर करने का सुरक्षित तरीका उपलब्ध कराता है.

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

Picker API का फ़्लो

Picker API के काम करने के तरीके के बारे में खास जानकारी यहां दी गई है:

  1. OAuth टोकन की जांच करें: Picker API फ़्लो शुरू करने से पहले, उपयोगकर्ता के लिए मान्य OAuth 2.0 ऐक्सेस टोकन की जांच करें. अगर कोई टोकन नहीं है, तो टोकन पाने के लिए OAuth 2.0 ऑथराइज़ेशन फ़्लो शुरू करें.

  2. सेशन बनाएं: Picker API को कॉल करके, प्रोसेस शुरू करें. इससे नया सेशन बनाया जा सकता है. इस कॉल से, एक यूनीक pickerUri मिलेगा.

  3. उपयोगकर्ताओं को सीधे Google Photos ऐप्लिकेशन पर ले जाएं: अपने उपयोगकर्ताओं को pickerUri उपलब्ध कराएं. इसे क्लिक किए जा सकने वाले लिंक या क्यूआर कोड के तौर पर उपलब्ध कराया जा सकता है. इस यूआरएल से, उनका Google Photos ऐप्लिकेशन सुरक्षित तरीके से खुलेगा. वेब पर काम करने वाले ऐप्लिकेशन के लिए, इस यूआरआई में /autoclose जोड़कर, Google Photos की विंडो को अपने-आप बंद किया जा सकता है. ऐसा तब होगा, जब उपयोगकर्ता फ़ोटो चुन लेगा.

  4. उपयोगकर्ता मीडिया आइटम चुनता है: Google Photos ऐप्लिकेशन में, उपयोगकर्ता अपनी लाइब्रेरी ब्राउज़ कर सकते हैं. साथ ही, वे उन फ़ोटो और वीडियो को चुन सकते हैं जिन्हें उन्हें आपके ऐप्लिकेशन के साथ शेयर करना है. उपयोगकर्ता के फ़ोटो चुनने के अनुभव के बारे में खास जानकारी पढ़ें.

  5. सेशन को पोल करें: आपके ऐप्लिकेशन को समय-समय पर सेशन को पोल करना चाहिए, ताकि स्थिति की जांच की जा सके. आपको ऐसी mediaItemsSet प्रॉपर्टी चाहिए जो सही वैल्यू दिखाती हो. इससे पता चलता है कि उपयोगकर्ता ने अपनी पसंद के आइटम चुन लिए हैं.

  6. चुने गए मीडिया आइटम की सूची बनाएं: mediaItemsSet से सही वैल्यू मिलने के बाद, चुने गए मीडिया आइटम के बारे में जानकारी पाने के लिए, सूची बनाने के तरीके का इस्तेमाल किया जा सकता है.

  7. मीडिया आइटम वापस पाना और उनका इस्तेमाल करना: अब आपके पास चुने गए मीडिया आइटम का ऐक्सेस है. baseUrl का इस्तेमाल करके, उनका कॉन्टेंट फ़ेच किया जा सकता है. साथ ही, उन्हें अपने ऐप्लिकेशन में इस्तेमाल किया जा सकता है.

अगले चरण

  • रेफ़रंस दस्तावेज़ देखें: उपलब्ध सभी तरीकों और पैरामीटर के बारे में जानने के लिए, Picker API के रेफ़रंस दस्तावेज़ को ध्यान से पढ़ें.
  • सैंपल आज़माएं: Picker API को ऐक्शन में देखने के लिए, हमारा सैंपल देखें. साथ ही, इंटिग्रेशन के लिए प्रेरणा पाएं.