जब कोई उपयोगकर्ता कोई फ़ाइल बनाता या खोलता है, तब 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 के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को सेट अप करें
- Google API (एपीआई) कंसोल में, मेन्यू > एपीआई और सेवाएं > चालू किए गए एपीआई और सेवाएं. पर जाएं
- एपीआई के सबसे नीचे और सेवाएं डैशबोर्ड के लिए, Google Drive API पर क्लिक करें. कॉन्टेंट बनाने ऐसा करने पर, Google Drive API का कॉन्फ़िगरेशन पेज दिखेगा.
- Drive यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन टैब चुनें.
- (ज़रूरी नहीं) ऐप्लिकेशन का नाम फ़ील्ड में कोई नाम डालें. ऐप्लिकेशन उपयोगकर्ताओं को Drive में, 'ऐप्लिकेशन मैनेज करें' टैब में वह नाम दिखेगा सेटिंग.
- (ज़रूरी नहीं) छोटा ब्यौरा में एक लाइन का छोटा ब्यौरा डालें फ़ील्ड में डालें. यह जानकारी, उपयोगकर्ताओं को 'ऐप्लिकेशन मैनेज करें' टैब में दिखती है Drive की सेटिंग.
- (ज़रूरी नहीं) बड़ा ब्यौरा फ़ील्ड में पूरा ब्यौरा डालें.
उपयोगकर्ता की सूची में दिखाने के लिए एक या ज़्यादा ऐप्लिकेशन आइकॉन अपलोड करें कनेक्ट किए गए डिस्क ऐप्लिकेशन और "इससे खोलें" में संदर्भ मेन्यू का इस्तेमाल करें. आइकॉन, पारदर्शी बैकग्राउंड के साथ PNG फ़ॉर्मैट में होने चाहिए. आइकॉन यह ले सकते हैं Drive में दिखने के लिए 24 घंटे लग सकते हैं.
Drive यूज़र इंटरफ़ेस (यूआई) के "इसमें खोलें" विकल्प का इस्तेमाल करने के लिए मेन्यू आइटम, में अपने ऐप्लिकेशन का URL यूआरएल खोलें फ़ील्ड. इस URL का उपयोग "इससे खोलें" संदर्भ मेन्यू का इस्तेमाल करें.
- इस यूआरएल में पूरी तरह क्वालिफ़ाइड डोमेन नेम होना चाहिए;
localhost
के पास यह काम नहीं करता काम. - यह यूआरएल, आपके ऐप्लिकेशन के सही उपयोगकर्ताओं के लिए ऐक्सेस होना चाहिए. अगर आपके पास ऐप्लिकेशन के कई वर्शन हैं, जैसे कि सार्वजनिक वर्शन वाला एक वर्शन एक वर्शन रिलीज़ किया जा सकता है. साथ ही, चुनिंदा उपयोगकर्ताओं के लिए एक सीमित रिलीज़ का इस्तेमाल किया जा सकता है. को एक अद्वितीय URL का उपयोग करना चाहिए. इसके बाद, कोई दूसरा ऐप्लिकेशन बनाया जा सकता है कॉन्फ़िगरेशन का इस्तेमाल किया जा सकता है.
- आपको ऐसा ज़रूर करना चाहिए इस यूआरएल के मालिकाना हक की पुष्टि करें अपने ऐप्लिकेशन को Google Workspace Marketplace में लिस्ट करें.
- डिफ़ॉल्ट रूप से, पास करने के लिए इस यूआरएल में
state
क्वेरी पैरामीटर जोड़ा जाता है आपके ऐप्लिकेशन में ट्रांसफ़र किया जा सकता है. इस पर जानकारी के लिएstate
पैरामीटर की सामग्री के लिए,state
पैरामीटर.
- इस यूआरएल में पूरी तरह क्वालिफ़ाइड डोमेन नेम होना चाहिए;
(ज़रूरी नहीं) इसमें डिफ़ॉल्ट MIME टाइप और फ़ाइल एक्सटेंशन डालें डिफ़ॉल्ट MIME टाइप और डिफ़ॉल्ट फ़ाइल एक्सटेंशन फ़ील्ड. डिफ़ॉल्ट MIME टाइप और फ़ाइल एक्सटेंशन, उन फ़ाइलों को दिखाते हैं जिन्हें आपका ऐप्लिकेशन खास तौर पर बनाया गया है खोलें. उदाहरण के लिए, आपका ऐप्लिकेशन लेयरिंग के लिए पहले से मौजूद फ़ॉर्मैट खोल सकता है और इमेज नहीं बदल सकते. सिर्फ़ स्टैंडर्ड मीडिया शामिल करें टाइप और पक्का करें कि उनमें टाइपिंग और स्पेलिंग की कोई गलती न हो. अगर आपका ऐप्लिकेशन सिर्फ़ खुलता है शॉर्टकट या तीसरे पक्ष की शॉर्टकट फ़ाइलों का इस्तेमाल करते हैं, तो आप MIME टाइप वाले फ़ील्ड को खाली छोड़ सकते हैं.
(ज़रूरी नहीं) सेकंडरी MIME टाइप और फ़ाइल एक्सटेंशन को सेकंडरी MIME टाइप और सेकंडरी फ़ाइल एक्सटेंशन वाले फ़ील्ड. सेकंडरी MIME टाइप और फ़ाइल एक्सटेंशन उन फ़ाइलों को दिखाते हैं जिन्हें आपका ऐप्लिकेशन खोल सकता है. हालांकि, ये अलग-अलग तरह के हो सकते हैं आपके ऐप्लिकेशन को मिलता है. उदाहरण के लिए, आपका ऐप्लिकेशन, इमेज में बदलाव करने वाला कोई ऐसा ऐप्लिकेशन हो सकता है जो PNG और JPG इमेज. सिर्फ़ स्टैंडर्ड मीडिया शामिल करें टाइप और पक्का करें कि उनमें टाइपिंग और स्पेलिंग की कोई गलती न हो. अगर आपका ऐप्लिकेशन सिर्फ़ खुलता है शॉर्टकट या तीसरे पक्ष की शॉर्टकट फ़ाइलों का इस्तेमाल करते हैं, तो आप MIME टाइप वाले फ़ील्ड को खाली छोड़ सकते हैं.
Drive यूज़र इंटरफ़ेस (यूआई) के "नया" का इस्तेमाल करने के लिए बटन और उपयोगकर्ताओं को इसकी मदद से फ़ाइल बनाने के लिए कहें अपने ऐप्लिकेशन के लिए, फ़ाइलें बनाना बॉक्स पर सही का निशान लगाएं. नया यूआरएल और वैकल्पिक दस्तावेज़ का नाम फ़ील्ड दिखते हैं.
- इस यूआरएल में पूरी तरह क्वालिफ़ाइड डोमेन नेम होना चाहिए;
localhost
के पास यह काम नहीं करता काम. - आपको इसका स्वामित्व सत्यापित करना होगा यूआरएल अपने ऐप्लिकेशन को Google Workspace Marketplace में लिस्ट करें.
- डिफ़ॉल्ट रूप से, पास करने के लिए इस यूआरएल में
state
क्वेरी पैरामीटर जोड़ा जाता है आपके ऐप्लिकेशन में ट्रांसफ़र किया जा सकता है. इस पर जानकारी के लिएstate
पैरामीटर की सामग्री के लिए,state
पैरामीटर.
- इस यूआरएल में पूरी तरह क्वालिफ़ाइड डोमेन नेम होना चाहिए;
नया यूआरएल फ़ील्ड में कोई यूआरएल डालें. इस यूआरएल का इस्तेमाल "नया" बटन का इस्तेमाल करें.
(ज़रूरी नहीं) अगर आपको अपने ऐप्लिकेशन में Google Workspace के साथ काम करने वाली फ़ाइलें खोलने की अनुमति देनी है, तो इंपोर्ट किया जा रहा है बॉक्स पर सही का निशान लगाएं.
(ज़रूरी नहीं) अगर आपके ऐप्लिकेशन को शेयर की गई ड्राइव पर मौजूद फ़ाइलें मैनेज करनी हैं, तो शेयर की गई ड्राइव के लिए सहायता बॉक्स. आपकी सहायता करने के लिए, अपने ऐप्लिकेशन में शेयर की गई ड्राइव, शेयर की गई ड्राइव लागू करना देखें सहायता पर जाएं.
सबमिट करें पर क्लिक करें.
drive.install
स्कोप का अनुरोध करें
ऐप्लिकेशन को "इसमें खोलें" विकल्प के तौर पर दिखाने के लिए या "नया" मेन्यू,
इंटिग्रेट करने के लिए, https://www.googleapis.com/auth/drive.install
स्कोप का अनुरोध करें
को भी ऐक्सेस कर सकते हैं. इस दायरे के लिए अनुरोध करने पर, उपयोगकर्ताओं को
इसके समान डायलॉग:
![Google Drive के यूज़र इंटरफ़ेस (यूआई) को इंस्टॉल करने का डायलॉग बॉक्स.](https://developers-dot-devsite-v2-prod.appspot.com/static/drive/images/install-scope.png?authuser=8&hl=hi)
Drive ऐप्लिकेशन के लिए जिन दायरों का अनुरोध किया जा सकता है उनके बारे में ज़्यादा जानकारी के लिए, और उनका अनुरोध करने का तरीका जानने के लिए, API-विशिष्ट प्राधिकरण और प्रमाणीकरण देखें जानकारी.
state
पैरामीटर
डिफ़ॉल्ट रूप से, state
पैरामीटर को ओपन यूआरएल और नया यूआरएल, दोनों में जोड़ा जाता है
का इस्तेमाल करें. यह पैरामीटर
में JSON-एन्कोडेड स्ट्रिंग, जिसमें टेम्प्लेट वैरिएबल और
आपके ऐप्लिकेशन को डाउनलोड करने का अनुरोध करता है. शामिल किए गए वैरिएबल, इस बात पर निर्भर करते हैं कि यूआरएल किस तरह का है (ओपन
यूआरएल या नया यूआरएल):
टेंप्लेट वैरिएबल | ब्यौरा | यूआरएल ऐप्लिकेशन |
---|---|---|
{ids} |
खोले जा रहे फ़ाइल आईडी की कॉमा-सेपरेटेड लिस्ट. | यूआरएल खोलें |
{exportIds} |
एक्सपोर्ट किए जा रहे फ़ाइल आईडी की कॉमा-सेपरेटेड लिस्ट (सिर्फ़ इस्तेमाल की गई) Google दस्तावेज़ों को खोलते समय). | यूआरएल खोलें |
{resourceKeys} |
फ़ाइल आईडी की JSON डिक्शनरी, जिसे उनके संसाधन के साथ मैप किया गया है बटन का इस्तेमाल करें. | यूआरएल खोलें |
{folderId} |
पैरंट फ़ोल्डर का आईडी. | नया URL |
{folderResourceKey} |
पैरंट फ़ोल्डर की संसाधन कुंजी. | नया URL |
{userId} |
वह प्रोफ़ाइल आईडी जिससे उपयोगकर्ता की पहचान होती है. | यूआरएल और नया यूआरएल खोलें |
{action} |
की जा रही कार्रवाई. मान है
ओपन यूआरएल या create का इस्तेमाल करते समय open
क्लिक करें.
|
यूआरएल और नया यूआरएल खोलें |
state
पैरामीटर, यूआरएल के कोड में बदला गया है, इसलिए आपके ऐप्लिकेशन को एस्केप को मैनेज करना चाहिए
और उसे JSON के रूप में पार्स करें. ऐप्लिकेशन इसमें create
वैल्यू का पता लगा सकते हैं
फ़ाइल बनाने के अनुरोध की पुष्टि करने के लिए state
पैरामीटर.
नए यूआरएल के लिए, 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 के यूज़र इंटरफ़ेस (यूआई) के "इसमें खोलें" सुविधा के साथ इंटिग्रेट करना कॉन्टेक्स्ट मेन्यू.