Drive यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन कॉन्फ़िगर करना

जब कोई उपयोगकर्ता फ़ाइल बनाता है या खोलता है, तब Google Drive में आपका ऐप्लिकेशन दिखाने के लिए, आपको सबसे पहले Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को सेट अप करना होगा. Google Workspace Marketplace में अपना ऐप्लिकेशन लिस्ट करने के लिए भी कॉन्फ़िगरेशन करना ज़रूरी है.

Drive API को चालू करना

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

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

• Google Cloud Console में, Google Drive API को चालू करें.

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

Drive के यूज़र इंटरफ़ेस (यूआई) को इंटिग्रेट करना

1. Google API Console में, मेन्यू menu &gt एपीआई और सेवाएं &gt चालू किए गए एपीआई और सेवाएं पर जाएं.

   चालू किए गए एपीआई और सेवाओं पर जाएं

2. एपीआई और सेवाएं डैशबोर्ड में सबसे नीचे, Google Drive API पर क्लिक करें. इसके बाद, Google Drive API का कॉन्फ़िगरेशन पेज दिखेगा.
3. Drive के यूज़र इंटरफ़ेस (यूआई) के साथ इंटिग्रेशन टैब चुनें.
4. (ज़रूरी नहीं) ऐप्लिकेशन का नाम फ़ील्ड में कोई नाम डालें. ऐप्लिकेशन का नाम, उपयोगकर्ताओं को Drive की सेटिंग में मौजूद 'ऐप्लिकेशन मैनेज करें' टैब में दिखता है.
5. (ज़रूरी नहीं) कम शब्दों में जानकारी फ़ील्ड में, एक लाइन में कम शब्दों में जानकारी डालें. कम शब्दों में दी गई जानकारी, उपयोगकर्ताओं को Drive की सेटिंग में जाकर 'ऐप्लिकेशन मैनेज करें' टैब में दिखती है.
6. (ज़रूरी नहीं) ज़्यादा जानकारी फ़ील्ड में पूरी जानकारी डालें.

7. एक या उससे ज़्यादा ऐप्लिकेशन आइकॉन अपलोड करें, ताकि वे उपयोगकर्ता को Drive से कनेक्ट किए गए ऐप्लिकेशन की सूची में दिखें. साथ ही, "इससे खोलें" कॉन्टेक्स्ट मेन्यू में भी दिखें. आइकॉन, पारदर्शी बैकग्राउंड वाले PNG फ़ॉर्मैट में होने चाहिए. Drive में आइकॉन दिखने में 24 घंटे लग सकते हैं.

8. Drive के यूज़र इंटरफ़ेस (यूआई) में मौजूद "इससे खोलें" मेन्यू आइटम का इस्तेमाल करने के लिए, खोलने का यूआरएल फ़ील्ड में अपने ऐप्लिकेशन का यूआरएल डालें. इस यूआरएल का इस्तेमाल "इससे खोलें" कॉन्टेक्स्ट मेन्यू करता है.

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

9. (वैकल्पिक) डिफ़ॉल्ट MIME टाइप और डिफ़ॉल्ट फ़ाइल एक्सटेंशन फ़ील्ड में, डिफ़ॉल्ट MIME टाइप और फ़ाइल एक्सटेंशन डालें. डिफ़ॉल्ट एमआईएमई टाइप और फ़ाइल एक्सटेंशन, उन फ़ाइलों को दिखाते हैं जिन्हें खोलने के लिए आपका ऐप्लिकेशन खास तौर पर बनाया गया है. उदाहरण के लिए, आपका ऐप्लिकेशन इमेज को लेयर करने और उनमें बदलाव करने के लिए, पहले से मौजूद फ़ॉर्मैट खोल सकता है. सिर्फ़ स्टैंडर्ड मीडिया टाइप शामिल करें. साथ ही, पक्का करें कि इनमें टाइपिंग की कोई गलती न हो और स्पेलिंग सही हो. अगर आपका ऐप्लिकेशन सिर्फ़ शॉर्टकट या तीसरे पक्ष के शॉर्टकट की फ़ाइलें खोलता है, तो MIME टाइप को खाली छोड़ा जा सकता है.

10. (ज़रूरी नहीं) अन्य MIME टाइप और अन्य फ़ाइल एक्सटेंशन फ़ील्ड में, अन्य MIME टाइप और फ़ाइल एक्सटेंशन डालें. सेकंडरी एमआईएमआई टाइप और फ़ाइल एक्सटेंशन, उन फ़ाइलों को दिखाते हैं जिन्हें आपका ऐप्लिकेशन खोल सकता है. हालांकि, ये आपके ऐप्लिकेशन के लिए खास नहीं होते. उदाहरण के लिए, आपका ऐप्लिकेशन इमेज में बदलाव करने वाला ऐप्लिकेशन हो सकता है, जो PNG और JPG इमेज खोलता है. सिर्फ़ स्टैंडर्ड मीडिया टाइप शामिल करें. साथ ही, पक्का करें कि इनमें टाइपिंग की कोई गलती न हो और स्पेलिंग सही हो. अगर आपका ऐप्लिकेशन सिर्फ़ शॉर्टकट या तीसरे पक्ष के शॉर्टकट की फ़ाइलें खोलता है, तो MIME टाइप को खाली छोड़ा जा सकता है.

11. Drive के यूज़र इंटरफ़ेस (यूआई) में मौजूद "नया" बटन का इस्तेमाल करने और उपयोगकर्ताओं को आपके ऐप्लिकेशन की मदद से फ़ाइल बनाने की अनुमति देने के लिए, फ़ाइलें बनाना बॉक्स पर सही का निशान लगाएं. आपको नया यूआरएल और दस्तावेज़ का नाम फ़ील्ड दिखेंगे. दस्तावेज़ का नाम फ़ील्ड भरना ज़रूरी नहीं है.

    • इस यूआरएल में पूरी तरह क्वालिफ़ाइड डोमेन नेम होना चाहिए. localhost काम नहीं करता.
    • Google Workspace Marketplace में अपना ऐप्लिकेशन लिस्ट करने से पहले, आपको इस यूआरएल के मालिकाना हक की पुष्टि करनी होगी.
    • डिफ़ॉल्ट रूप से, इस यूआरएल में state क्वेरी पैरामीटर जोड़ा जाता है, ताकि Drive के यूज़र इंटरफ़ेस (यूआई) से आपके ऐप्लिकेशन को डेटा भेजा जा सके. state पैरामीटर के कॉन्टेंट के बारे में जानने के लिए, state पैरामीटर लेख पढ़ें.

12. नया यूआरएल फ़ील्ड में यूआरएल डालें. इस यूआरएल का इस्तेमाल "नया" बटन करता है, ताकि उपयोगकर्ता को आपके ऐप्लिकेशन पर रीडायरेक्ट किया जा सके.

13. (ज़रूरी नहीं) अगर आपको अपने ऐप्लिकेशन में Google Workspace के साथ काम करने वाली फ़ाइलें खोलनी हैं, तो इंपोर्ट करना बॉक्स पर सही का निशान लगाएं.

14. (ज़रूरी नहीं) अगर आपके ऐप्लिकेशन को शेयर की गई ड्राइव पर मौजूद फ़ाइलें मैनेज करनी हैं, तो शेयर की गई ड्राइव के साथ काम करता है बॉक्स को चुनें. अपने ऐप्लिकेशन में शेयर की गई ड्राइव का इस्तेमाल करने की सुविधा जोड़ने के बारे में ज़्यादा जानने के लिए, शेयर की गई ड्राइव का इस्तेमाल करने की सुविधा जोड़ना लेख पढ़ें.

15. सबमिट करें पर क्लिक करें.

drive.install के स्कोप का अनुरोध करना

ऐप्लिकेशन को "इसके साथ खोलें" या "नया" मेन्यू में विकल्प के तौर पर दिखने की अनुमति देने के लिए, Drive के यूज़र इंटरफ़ेस (यूआई) के साथ इंटिग्रेट करने के लिए https://www.googleapis.com/auth/drive.install स्कोप का अनुरोध करें. इस स्कोप का अनुरोध करने पर, उपयोगकर्ताओं को इस तरह का डायलॉग दिखता है:

Drive ऐप्लिकेशन के लिए अनुरोध किए जा सकने वाले स्कोप और उनके लिए अनुरोध करने के तरीके के बारे में ज़्यादा जानने के लिए, एपीआई के हिसाब से अनुमति और पुष्टि करने के बारे में जानकारी देखें.

state पैरामीटर

डिफ़ॉल्ट रूप से, Drive के यूज़र इंटरफ़ेस (यूआई) से आपके ऐप्लिकेशन तक डेटा पास करने के लिए, Open URL और New URL, दोनों में state पैरामीटर जोड़ा जाता है. इस पैरामीटर में, टेंप्लेट वैरिएबल के साथ-साथ आपके ऐप्लिकेशन के अनुरोध के बारे में जानकारी देने वाली JSON-कोड वाली स्ट्रिंग होती है. शामिल किए गए वैरिएबल, इस्तेमाल किए गए यूआरएल के टाइप (Open URL या New URL) पर निर्भर करते हैं:

state पैरामीटर को यूआरएल के हिसाब से कोड में बदला जाता है. इसलिए, आपके ऐप्लिकेशन को एस्केप वर्णों को मैनेज करना होगा और इसे JSON के तौर पर पार्स करना होगा. ऐप्लिकेशन, फ़ाइल बनाने के अनुरोध की पुष्टि करने के लिए, state पैरामीटर में create वैल्यू का पता लगा सकते हैं.

नए यूआरएल के लिए, JSON में राज्य की जानकारी का उदाहरण

नए यूआरएल के लिए state जानकारी यह है:

{
  "action":"create",
  "folderId":"FOLDER_ID",
  "folderResourceKey":"FOLDER_RESOURCE_KEY",
  "userId":"USER_ID"
}

ओपन यूआरएल के लिए, JSON में राज्य की जानकारी का उदाहरण

ओपन यूआरएल के लिए state की जानकारी यह है:

{
  "ids": ["ID"],
  "resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
  "action":"open",
  "userId":"USER_ID"
}

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

मिलते-जुलते विषय

इंस्टॉल किए गए ऐप्लिकेशन में, Drive के यूज़र इंटरफ़ेस (यूआई) से लॉन्च की गई कार्रवाइयों को बनाने, मैनेज करने, और खोलने की सुविधा होनी चाहिए. ज़्यादा जानने के लिए, Drive के यूज़र इंटरफ़ेस (यूआई) में मौजूद "नया" बटन के साथ इंटिग्रेट करना या Drive के यूज़र इंटरफ़ेस (यूआई) में मौजूद "इससे खोलें" कॉन्टेक्स्ट मेन्यू के साथ इंटिग्रेट करना लेख पढ़ें.