इस दस्तावेज़ में, Google Picker और Google Picker API के बारे में बताया गया है. इससे आपको यह तय करने में भी मदद मिलती है कि आपके ऐप्लिकेशन के लिए कौनसा तरीका सबसे अच्छा है.
Google Picker, Google Drive में सेव की गई जानकारी के लिए, "फ़ाइल खोलें" डायलॉग उपलब्ध कराता है. इसकी मदद से, लोग आपके ऐप्लिकेशन से बाहर निकले बिना, अपने Drive खाते से फ़ोटो, वीडियो, और दस्तावेज़ चुन सकते हैं या अपलोड कर सकते हैं.
Google Picker API, एक टेक्निकल इंटरफ़ेस है. इसका इस्तेमाल, आपके ऐप्लिकेशन में Google Picker को लागू करने के लिए किया जाता है. Google Picker API का इस्तेमाल करके, एक ऐसा इंटरफ़ेस बनाया जाता है जो उपयोगकर्ताओं को जाना-पहचाना लगता है. यह इंटरफ़ेस, पुष्टि करने और फ़ाइल ब्राउज़ करने की जटिलता को मैनेज करता है. साथ ही, जब कोई उपयोगकर्ता फ़ाइल चुनता है, तो यह आपके ऐप्लिकेशन को फ़ाइल का मेटाडेटा (जैसे कि आईडी और यूआरएल) वापस भेजता है.
इस्तेमाल के मुख्य उदाहरण
Google Picker एक वर्सटाइल टूल है. इसे अलग-अलग ऐप्लिकेशन वर्कफ़्लो के हिसाब से बनाया जा सकता है:
- फ़ाइल अपलोड करने का दूसरा तरीका: उपयोगकर्ता, Google Picker के ज़रिए सीधे Drive में फ़ाइल अपलोड कर सकते हैं.
- मिलकर काम करने में मददगार टूल: इनकी मदद से, उपयोगकर्ता किसी प्रोजेक्ट मैनेजमेंट टास्क या शेयर किए गए कैलेंडर इवेंट में, Google Docs या Google Sheets को लिंक कर सकते हैं.
- ऐसेट अटैचमेंट: Google Picker का इस्तेमाल करके, उपयोगकर्ताओं को Drive से किसी खर्च की रिपोर्ट या सहायता टिकट में ज़रूरी दस्तावेज़ अटैच करने की सुविधा दें.
वेब ऐप्लिकेशन की तुलना डेस्कटॉप और मोबाइल ऐप्लिकेशन से करना
मुख्य फ़ंक्शन एक जैसे ही रहते हैं. हालांकि, Google Picker API को लागू करने का तरीका अलग-अलग होता है. यह इस बात पर निर्भर करता है कि आपका ऐप्लिकेशन कहां चल रहा है. यहां दी गई तुलना टेबल में, वेब ऐप्लिकेशन के साथ-साथ डेस्कटॉप और मोबाइल ऐप्लिकेशन के लिए, Google Picker API को लागू करने के तकनीकी और फ़ंक्शनल अंतर बताए गए हैं.
| सुविधा | वेब ऐप्लिकेशन | डेस्कटॉप और मोबाइल ऐप्लिकेशन |
|---|---|---|
| प्राइमरी टेक्नोलॉजी | क्लाइंट-साइड JavaScript लाइब्रेरी. | OAuth 2.0 यूआरएल पैरामीटर और एचटीटीपी रीडायरेक्ट. |
| रेंडरिंग | यह ऐप्लिकेशन के मौजूदा यूज़र इंटरफ़ेस (यूआई) लेआउट में इंटिग्रेट हो जाता है. | यह उपयोगकर्ता के सिस्टम के डिफ़ॉल्ट ब्राउज़र के नए टैब में खुलता है. अब इसे एम्बेड किए गए वेबव्यू में नहीं दिखाया जा सकता. |
| पुष्टि करने का फ़्लो | इसके लिए, setOAuthToken के ज़रिए पास किया गया कोई खास ऐक्सेस टोकन ज़रूरी है. |
यह तब ट्रिगर होता है, जब OAuth अनुरोध में trigger_onepick=true जोड़ा जाता है. |
| जवाब देने का तरीका | JavaScript के डायरेक्ट कॉलबैक. | रीडायरेक्ट यूआरआई या कस्टम यूआरएल स्कीम. |
| स्कोप | महीने के हिसाब से; drive.file, drive.readonly वगैरह का इस्तेमाल किया जा सकता है |
सख्त; सिर्फ़ drive.file की अनुमति है और इसे अन्य स्कोप के साथ नहीं जोड़ा जा सकता. |
| कॉन्फ़िगरेशन | यह कुकी, JavaScript में PickerBuilder फ़्लुएंट इंटरफ़ेस का इस्तेमाल करती है. |
यह अनुमति देने वाले यूआरएल में क्वेरी स्ट्रिंग पैरामीटर का इस्तेमाल करता है. |
ध्यान दें कि drive.file स्कोप का इस्तेमाल करने के लिए, उपयोगकर्ता को Google Picker ऐक्सेस करते समय साइन इन करना होगा.
रणनीति से जुड़े मुख्य अंतर ये हैं:
- वेब ऐप्लिकेशन को ज़्यादा इंटरैक्टिव और ज़रूरत के मुताबिक बनाने के लिए डिज़ाइन किया गया है. जैसे, फ़ाइल टाइप के हिसाब से खास व्यू और Drive के कुछ फ़ोल्डर को देखने पर पाबंदी लगाना.
- डेस्कटॉप और मोबाइल ऐप्लिकेशन को सुरक्षा और आसानी से इस्तेमाल करने के लिए डिज़ाइन किया गया है. ये पुष्टि करने और फ़ाइल चुनने के लिए, सिस्टम ब्राउज़र का इस्तेमाल करते हैं. यह सब एक ही यूनिफ़ाइड फ़्लो में होता है.
मिलते-जुलते विषय
- Google Picker को वेब ऐप्लिकेशन में इंटिग्रेट करना
- Google Picker को डेस्कटॉप और मोबाइल ऐप्लिकेशन में इंटिग्रेट करना
- Google Drive API के स्कोप चुनना