डेस्कटॉप ऐप्लिकेशन के बारे में खास जानकारी

Google Picker API की मदद से, उपयोगकर्ता Google Drive में मौजूद फ़ाइलें चुन सकते हैं या अपलोड कर सकते हैं. उपयोगकर्ता, आपके डेस्कटॉप ऐप्लिकेशन को अपने Drive डेटा को ऐक्सेस करने की अनुमति दे सकते हैं. इससे उन्हें अपनी फ़ाइलों के साथ सुरक्षित और अनुमति वाला इंटरैक्शन करने का तरीका मिलता है.

Google Picker, Drive पर सेव की गई फ़ाइलों के लिए "फ़ाइल खोलें" डायलॉग के तौर पर काम करता है. इसमें कई सुविधाएं होती हैं:

  • इसका लुक और फ़ील, Google Drive के यूज़र इंटरफ़ेस (यूआई) जैसा है.
  • Drive की फ़ाइलों की झलक और थंबनेल इमेज दिखाने वाले कई व्यू.
  • उपयोगकर्ता के डिफ़ॉल्ट ब्राउज़र में, नए टैब में Google Picker पर रीडायरेक्ट किया जाता है.

ध्यान दें कि Google Picker, उपयोगकर्ताओं को एक फ़ोल्डर से दूसरे फ़ोल्डर में फ़ाइलों को व्यवस्थित करने, ले जाने या कॉपी करने की अनुमति नहीं देता. फ़ाइलों को मैनेज करने के लिए, आपको Google Drive API या Drive के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल करना होगा.

ज़रूरी शर्तें

Google Picker का इस्तेमाल करने वाले ऐप्लिकेशन को, सेवा की सभी मौजूदा शर्तों का पालन करना होगा. सबसे ज़रूरी बात यह है कि आपको अपने अनुरोधों में अपनी पहचान सही तरीके से बतानी होगी.

आपके पास Google Cloud प्रोजेक्ट भी होना चाहिए.

अपना एनवायरमेंट सेट अप करने का तरीका

Google Picker API का इस्तेमाल शुरू करने के लिए, आपको अपना एनवायरमेंट सेट अप करना होगा.

एपीआई चालू करना

Google API का इस्तेमाल करने से पहले, आपको उन्हें Google Cloud प्रोजेक्ट में चालू करना होगा. एक ही Google Cloud प्रोजेक्ट में, एक या उससे ज़्यादा एपीआई चालू किए जा सकते हैं.

एपीआई पासकोड बनाना

एपीआई कुंजी एक लंबी स्ट्रिंग होती है. इसमें अंग्रेज़ी के बड़े और छोटे अक्षर, नंबर, अंडरस्कोर, और हाइफ़न होते हैं. जैसे, AIzaSyDaGmWKa4JsXZ-HjGw7ISLn_3namBGewQe. पुष्टि करने के इस तरीके का इस्तेमाल, सार्वजनिक तौर पर उपलब्ध डेटा को पहचान छिपाकर ऐक्सेस करने के लिए किया जाता है. जैसे, "इंटरनेट पर मौजूद कोई भी व्यक्ति जिसके पास यह लिंक है" सेटिंग का इस्तेमाल करके शेयर की गई Google Workspace फ़ाइलें. ज़्यादा जानकारी के लिए, एपीआई कुंजियां मैनेज करना लेख पढ़ें.

एपीआई पासकोड बनाने के लिए:

  1. Google Cloud console में, मेन्यू > एपीआई और सेवाएं > क्रेडेंशियल पर जाएं.

    क्रेडेंशियल पर जाएं

  2. क्रेडेंशियल बनाएं > एपीआई कुंजी पर क्लिक करें.
  3. आपको नई एपीआई कुंजी दिखेगी.
    • अपने ऐप्लिकेशन के कोड में इस्तेमाल करने के लिए, एपीआई पासकोड कॉपी करने के लिए, कॉपी करें पर क्लिक करें. एपीआई पासकोड, आपके प्रोजेक्ट के क्रेडेंशियल के "एपीआई पासकोड" सेक्शन में भी देखा जा सकता है.
    • हमारा सुझाव है कि बिना अनुमति के इस्तेमाल को रोकने के लिए, यह तय करें कि एपीआई कुंजी का इस्तेमाल कहां और किन एपीआई के लिए किया जा सकता है. ज़्यादा जानकारी के लिए, एपीआई पर पाबंदियां जोड़ना लेख पढ़ें.

डेस्कटॉप ऐप्लिकेशन के लिए क्रेडेंशियल को अनुमति देना

असली उपयोगकर्ताओं की पुष्टि करने और अपने ऐप्लिकेशन में उपयोगकर्ता का डेटा ऐक्सेस करने के लिए, आपको एक या उससे ज़्यादा OAuth 2.0 क्लाइंट आईडी बनाने होंगे. क्लाइंट आईडी का इस्तेमाल, Google के OAuth सर्वर पर किसी एक ऐप्लिकेशन की पहचान करने के लिए किया जाता है. अगर आपका ऐप्लिकेशन कई प्लैटफ़ॉर्म पर चलता है, तो आपको हर प्लैटफ़ॉर्म के लिए अलग क्लाइंट आईडी बनाना होगा.
  1. Google API Console में, मेन्यू > Google Auth platform > क्लाइंट पर जाएं.

    क्लाइंट पर जाएं

  2. क्लाइंट खाता बनाएं पर क्लिक करें.
  3. ऐप्लिकेशन का टाइप > डेस्कटॉप ऐप्लिकेशन पर क्लिक करें.
  4. नाम फ़ील्ड में, क्रेडेंशियल के लिए कोई नाम टाइप करें. यह नाम सिर्फ़ Google API Console में दिखता है.
  5. बनाएं पर क्लिक करें.

    नया क्रेडेंशियल, "OAuth 2.0 क्लाइंट आईडी" में दिखता है.

अगर ऐप्लिकेशन को उन फ़ाइलों का ऐक्सेस चाहिए जिनके लिए उसे पहले अनुमति दी गई थी, तो आपको यह तरीका अपनाना होगा:

  1. आपको drive.file, drive या drive.readonly स्कोप के साथ OAuth 2.0 टोकन हासिल करना होगा. इसके लिए, इन निर्देशों का पालन करें: OAuth 2.0 का इस्तेमाल करके, Google API को ऐक्सेस करना. स्कोप के बारे में ज़्यादा जानने के लिए, Google Drive API के स्कोप चुनना लेख पढ़ें.

  2. Drive API को OAuth 2.0 टोकन पास करें, ताकि उन फ़ाइलों को पढ़ा और उनमें बदलाव किया जा सके जिनके लिए उपयोगकर्ता ने पहले ही ऐक्सेस दिया है.

Google Picker को दिखाएं

डेस्कटॉप ऐप्लिकेशन के लिए Google Picker API, उपयोगकर्ता के डिफ़ॉल्ट ब्राउज़र में नए टैब में Google Picker पर रीडायरेक्ट करता है. जब उपयोगकर्ता ऐक्सेस देता है और काम की फ़ाइलें चुनता है, तो Google Picker, कॉलिंग ऐप्लिकेशन पर वापस आ जाता है. ऐसा कॉलबैक यूआरएल के ज़रिए होता है. अगर आपको Google Picker API को क्लाइंट पेज में खोलना है, तो वेब ऐप्लिकेशन के लिए Google Picker API का इस्तेमाल करें. ज़्यादा जानकारी के लिए, वेब ऐप्लिकेशन की खास जानकारी लेख पढ़ें.

उपयोगकर्ताओं को अतिरिक्त फ़ाइलों का ऐक्सेस देने या आपके डेस्कटॉप ऐप्लिकेशन के फ़्लो में इस्तेमाल करने के लिए फ़ाइलें चुनने की अनुमति देने के लिए, यह तरीका अपनाएं:

  1. इन निर्देशों का पालन करके, drive.file स्कोप के ऐक्सेस का अनुरोध करें, ताकि OAuth 2.0 ऐक्सेस पेज को ब्राउज़र के नए टैब में खोला जा सके: OAuth 2.0 का इस्तेमाल करके, Google API को ऐक्सेस करना. स्कोप के बारे में ज़्यादा जानने के लिए, Google Drive API के स्कोप चुनना लेख पढ़ें.

    ध्यान दें कि डेस्कटॉप ऐप्लिकेशन के लिए, सिर्फ़ drive.file स्कोप की अनुमति है. इसे किसी अन्य स्कोप के साथ नहीं जोड़ा जा सकता.

  2. नए ब्राउज़र टैब का यूआरएल, सभी स्टैंडर्ड OAuth क्वेरी स्ट्रिंग पैरामीटर स्वीकार करता है.

    आपको अपने OAuth 2.0 ऑथराइज़ेशन यूआरएल अनुरोध में, prompt और trigger_onepick यूआरएल पैरामीटर जोड़ने होंगे. Google Picker को कई वैकल्पिक पैरामीटर के साथ भी पसंद के मुताबिक बनाया जा सकता है:

    पैरामीटर ब्यौरा स्थिति
    prompt=consent फ़ाइल का ऐक्सेस पाने के लिए प्रॉम्प्ट. ज़रूरी है
    trigger_onepick=true Google Picker चालू करें. ज़रूरी है
    allow_multiple=true अगर यह वैल्यू सही है, तो उपयोगकर्ता को एक से ज़्यादा फ़ाइलें चुनने की अनुमति दें. वैकल्पिक
    mimetypes=MIMETYPES खोज के नतीजों को फ़िल्टर करने के लिए, कॉमा लगाकर अलग किए गए MIME टाइप की सूची. अगर इसे सेट नहीं किया जाता है, तो व्यू में सभी MIME टाइप की फ़ाइलें दिखती हैं. वैकल्पिक
    file_ids=FILE_IDS खोज के नतीजों को फ़िल्टर करने के लिए, कॉमा लगाकर अलग किए गए फ़ाइल आईडी की सूची. अगर इसे सेट नहीं किया जाता है, तो व्यू में सभी फ़ाइलें दिखती हैं. वैकल्पिक
    allow_folder_selection=true अगर इस नीति को 'सही है' पर सेट किया जाता है, तो उपयोगकर्ता को फ़ोल्डर चुनने की अनुमति दें. वैकल्पिक

    यहां OAuth 2.0 ऑथराइज़ेशन यूआरएल के अनुरोध का उदाहरण दिया गया है:

    https://accounts.google.com/o/oauth2/v2/auth? \
client_id=CLIENT_ID \
&scope=https://www.googleapis.com/auth/drive.file \
&redirect_uri=REDIRECT_URI \
&response_type=code \
&access_type=offline \
&prompt=consent \
&trigger_onepick=true

    इनकी जगह ये डालें:

    • CLIENT_ID: आपके डेस्कटॉप ऐप्लिकेशन का क्लाइंट आईडी.

    • REDIRECT_URI: यह वह जगह है जहां पुष्टि करने वाला सर्वर, पुष्टि हो जाने के बाद उपयोगकर्ता के ब्राउज़र को रीडायरेक्ट करता है. उदाहरण के लिए, https://www.cymbalgroup.com/oauth2callback.

    बताया गया redirect_uri, सार्वजनिक एचटीटीपीएस यूआरएल होना चाहिए. अगर आपको अपने redirect_uri के लिए कस्टम प्रोटोकॉल या लोकलहोस्ट यूआरएल का इस्तेमाल करना है, तो आपको एक ऐसे सार्वजनिक एचटीटीपीएस यूआरएल का इस्तेमाल करना होगा जो कस्टम प्रोटोकॉल या लोकलहोस्ट यूआरएल पर रीडायरेक्ट करता हो.

  3. जब उपयोगकर्ता ऐक्सेस देता है और काम की फ़ाइलें चुनता है, तो OAuth, अनुरोध में बताए गए redirect_uri पर रीडायरेक्ट करता है. साथ ही, यूआरएल में ये पैरामीटर जोड़ता है:

    • picked_file_ids: अगर उपयोगकर्ता ने ऐक्सेस दिया है और फ़ाइलें चुनी हैं, तो चुनी गई फ़ाइलों के आईडी की कॉमा लगाकर अलग की गई सूची.

    • code: यह ऐक्सेस टोकन या ऐक्सेस कोड होता है. यह अनुरोध में सेट किए गए response_type पैरामीटर पर आधारित होता है. इस पैरामीटर में नया अनुमति कोड शामिल है.

    • scope: अनुरोध में शामिल स्कोप.

    • error: अगर उपयोगकर्ता ने सहमति देने की प्रोसेस के दौरान अनुरोध रद्द कर दिया है, तो एक गड़बड़ी दिखेगी.

    यहां OAuth 2.0 ऑथराइज़ेशन यूआरएल रिस्पॉन्स का एक उदाहरण दिया गया है:

    https://REDIRECT_URI?picked_file_ids=PICKED_FILE_IDS&code=CODE&scope=SCOPES

  4. ऐप्लिकेशन को तीसरे चरण में मिले ऑथराइज़ेशन कोड के बदले, नया OAuth 2.0 टोकन पाना होगा. ज़्यादा जानकारी के लिए, रीफ़्रेश और ऐक्सेस टोकन के लिए ऑथराइज़ेशन कोड बदलना लेख पढ़ें.

  5. इसके बाद, ऐप्लिकेशन Drive API को कॉल करने के लिए, तीसरे चरण में यूआरएल पैरामीटर से मिले फ़ाइल आईडी और चौथे चरण में मिले OAuth 2.0 टोकन का इस्तेमाल कर सकते हैं. ज़्यादा जानकारी के लिए, Google Drive API की खास जानकारी देखें.