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

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 Cloud console में, मेन्यू > Google Auth platform > क्लाइंट पर जाएं.

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

  2. क्लाइंट बनाएं पर क्लिक करें.
  3. ऐप्लिकेशन का टाइप > डेस्कटॉप ऐप्लिकेशन पर क्लिक करें.
  4. नाम फ़ील्ड में, क्रेडेंशियल के लिए कोई नाम टाइप करें. यह नाम सिर्फ़ Google Cloud 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 खोज के नतीजों को फ़िल्टर करने के लिए, कॉमा लगाकर अलग किए गए फ़ाइल आईडी की सूची. अगर इसे सेट नहीं किया जाता है, तो व्यू में सभी फ़ाइलें दिखती हैं. वैकल्पिक

    यहां दिए गए उदाहरण में, 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 की खास जानकारी देखें.