जब कोई उपयोगकर्ता कोई फ़ाइल चुनता है और Drive के यूज़र इंटरफ़ेस (यूआई) के "इससे खोलें" मेन्यू आइटम पर क्लिक करता है, तो Drive, उपयोगकर्ता को उस ऐप्लिकेशन के ओपन यूआरएल पर रीडायरेक्ट कर देता है. यह यूआरएल, Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करें में बताया गया है.
अगर आपने Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करते समय "इंपोर्ट किया जा रहा है" बॉक्स चुना है, तो उपयोगकर्ता खोलने के लिए खास ऐप्लिकेशन और Google Workspace फ़ाइलों का कॉम्बिनेशन चुन सकता है. Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करने पर, ऐप्लिकेशन के हिसाब से बनी फ़ाइलें "डिफ़ॉल्ट MIME टाइप" और "डिफ़ॉल्ट फ़ाइल एक्सटेंशन" फ़ील्ड में दिखती हैं. वहीं, Google Workspace की फ़ाइलें, "सेकंडरी MIME टाइप" और "सेकंडरी फ़ाइल एक्सटेंशन" फ़ील्ड में तय की जाती हैं.
हर उस फ़ाइल के लिए जिसे उपयोगकर्ता खोलना चाहता है, Drive आपके तय किए गए डिफ़ॉल्ट और दूसरे MIME टाइप से MIME टाइप की जांच करता है:
"डिफ़ॉल्ट MIME टाइप" फ़ील्ड में बताए गए MIME टाइप के लिए, फ़ाइल आईडी आपके ऐप्लिकेशन को पास किया जाता है. ऐप्लिकेशन से जुड़ी खास फ़ाइलों को मैनेज करने के तरीके के बारे में जानकारी के लिए, ऐप्लिकेशन से जुड़े दस्तावेज़ों के लिए, ओपन यूआरएल मैनेज करना देखें.
"सेकंडरी MIME टाइप" फ़ील्ड में बताए गए MIME टाइप के लिए, Drive के यूज़र इंटरफ़ेस पर एक डायलॉग बॉक्स दिखता है. इस डायलॉग में उपयोगकर्ता से पूछा जाता है कि Google Workspace फ़ाइल को किस तरह के फ़ाइल टाइप में बदला जाए. उदाहरण के लिए, अगर Drive के यूज़र इंटरफ़ेस (यूआई) में कोई Google Docs फ़ाइल चुनी जाती है और "सेकंडरी MIME टाइप" फ़ील्ड से आपको अपने ऐप्लिकेशन में टेक्स्ट/सामान्य या ऐप्लिकेशन/pdf का सुझाव मिलता है, तो Drive का यूज़र इंटरफ़ेस (यूआई) उपयोगकर्ता से पूछता है कि क्या उन्हें सामान्य टेक्स्ट या PDF में बदलना है.
Google Workspace की फ़ाइलों को मैनेज करने का तरीका जानने के लिए, Google Workspace दस्तावेज़ों के लिए, ओपन यूआरएल मैनेज करना देखें. Google Workspace दस्तावेज़ों और MIME टाइप कन्वर्ज़न फ़ॉर्मैट की सूची के लिए, Google Workspace दस्तावेज़ों के लिए MIME टाइप एक्सपोर्ट करें देखें.
ऐप्लिकेशन के दस्तावेज़ों के लिए, ओपन यूआरएल मैनेज करना
जैसा कि Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करना लेख में बताया गया है,
आपके ऐप्लिकेशन को टेंप्लेट वैरिएबल मिलते हैं. इन वैरिएबल पर जानकारी होती है, ताकि ऐप्लिकेशन फ़ाइल खोल सके. आपके ऐप्लिकेशन को state
पैरामीटर में,
टेंप्लेट वैरिएबल का डिफ़ॉल्ट सेट मिलता है. ऐप्लिकेशन के लिए खास तौर पर बने, यूआरएल खोलने के लिए state
की डिफ़ॉल्ट जानकारी यह है:
{
"ids": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
इस आउटपुट में ये वैल्यू शामिल होती हैं:
- ID: पैरंट फ़ोल्डर का आईडी.
- RESOURCE_KEYS: फ़ाइल आईडी की एक JSON डिक्शनरी, जिसे उनसे जुड़े संसाधन कुंजियों से मैप किया गया है.
open
: की जाने वाली कार्रवाई. खुले यूआरएल का इस्तेमाल करते समय वैल्यूopen
होती है.- USER_ID: प्रोफ़ाइल आईडी, जिससे किसी व्यक्ति की पहचान होती है.
आपके ऐप्लिकेशन को इस अनुरोध पर कार्रवाई करने के लिए, यह तरीका अपनाना होगा:
- पुष्टि करें कि
action
फ़ील्ड की वैल्यूopen
हो औरids
फ़ील्ड मौजूद हो. - उपयोगकर्ता के लिए एक नया सेशन बनाने के लिए,
userId
वैल्यू का इस्तेमाल करें. साइन इन किए हुए उपयोगकर्ताओं के बारे में ज़्यादा जानकारी के लिए, उपयोगकर्ता और नए इवेंट देखें. - अनुमतियां देखने, फ़ाइल मेटाडेटा फ़ेच करने, और
ID
वैल्यू का इस्तेमाल करके फ़ाइल का कॉन्टेंट डाउनलोड करने के लिए,files.get
वाला तरीका इस्तेमाल करें. - अगर
resourceKeys
को अनुरोध पर सेट किया गया था, तोX-Goog-Drive-Resource-Keys
अनुरोध का हेडर सेट करें. संसाधन कुंजियों के बारे में ज़्यादा जानकारी के लिए, संसाधन कुंजियों का इस्तेमाल करके लिंक से शेयर की गई फ़ाइलें ऐक्सेस करना देखें.
state
पैरामीटर, यूआरएल के हिसाब से कोड में बदला जाता है. इसलिए, आपके ऐप्लिकेशन को एस्केप कैरेक्टर को हैंडल करना होगा और उसे JSON के तौर पर पार्स करना होगा.
Google Workspace के दस्तावेज़ों के लिए, ओपन यूआरएल मैनेज करना
जैसा कि Drive के यूज़र इंटरफ़ेस (यूआई) इंटिग्रेशन को कॉन्फ़िगर करना लेख में बताया गया है, आपके ऐप्लिकेशन को state
पैरामीटर में, टेंप्लेट वैरिएबल का डिफ़ॉल्ट सेट मिलता है. Google Workspace के ओपन यूआरएल के लिए, state
की डिफ़ॉल्ट जानकारी यह होती है:
{
"exportIds": ["ID"],
"resourceKeys":{"RESOURCE_KEYS":"RESOURCE_KEYS"},
"action":"open",
"userId":"USER_ID"
}
इस आउटपुट में ये वैल्यू शामिल होती हैं:
- EXPORT_ID: एक्सपोर्ट किए जा रहे फ़ाइल आईडी की कॉमा-सेपरेटेड लिस्ट. इसका इस्तेमाल सिर्फ़ पहले से मौजूद Google दस्तावेज़ों को खोलने पर किया जाता है.
- RESOURCE_KEYS: फ़ाइल आईडी की एक JSON डिक्शनरी, जिसे उनसे जुड़े संसाधन कुंजियों से मैप किया गया है.
open
: की जाने वाली कार्रवाई. खुले यूआरएल का इस्तेमाल करते समय वैल्यूopen
होती है.- USER_ID: वह प्रोफ़ाइल आईडी जिससे उपयोगकर्ता की पहचान होती है.
आपके ऐप्लिकेशन को इस अनुरोध पर कार्रवाई करने के लिए, यह तरीका अपनाना होगा:
पुष्टि करें कि यह अनुरोध, किसी फ़ाइल को खोलने के लिए किया गया है. इसके लिए,
state
फ़ील्ड मेंopen
वैल्यू औरexportIds
फ़ील्ड, दोनों का पता लगाएं.अनुमतियां देखने, फ़ाइल मेटाडेटा फ़ेच करने, और
EXPORT_ID
वैल्यू का इस्तेमाल करके MIME टाइप तय करने के लिए,files.get
वाला तरीका इस्तेमाल करें.files.export
तरीके का इस्तेमाल करके फ़ाइल का कॉन्टेंट बदलें. नीचे दिए गए कोड सैंपल में, Google Workspace दस्तावेज़ को अनुरोध किए गए MIME टाइप में एक्सपोर्ट करने का तरीका बताया गया है.अगर
resourceKey
को अनुरोध पर सेट किया गया था, तोX-Goog-Drive-Resource-Keys
अनुरोध का हेडर सेट करें. संसाधन कुंजियों के बारे में ज़्यादा जानकारी के लिए, संसाधन कुंजियों का इस्तेमाल करके लिंक से शेयर की गई फ़ाइलें ऐक्सेस करना देखें.Java
Python
Node.js
PHP
बदली गई फ़ाइलों को रीड-ओनली के तौर पर दिखाएं या ऐसा डायलॉग दिखाएं जिससे लोग फ़ाइल को नए फ़ाइल टाइप के तौर पर सेव कर सकें.
state
पैरामीटर, यूआरएल के हिसाब से कोड में बदला जाता है. इसलिए, आपके ऐप्लिकेशन को एस्केप कैरेक्टर को हैंडल करना होगा और उसे JSON के तौर पर पार्स करना होगा.
उपयोगकर्ता और नए इवेंट
डिस्क ऐप्लिकेशन को सभी "खुला है" इवेंट को संभावित साइन-इन मानते हुए
होना चाहिए. कुछ उपयोगकर्ताओं के पास एक से ज़्यादा खाते हो सकते हैं, इसलिए हो सकता है कि state
पैरामीटर में मौजूद यूज़र आईडी, मौजूदा सेशन से मेल न खाए. अगर state
पैरामीटर में मौजूद यूज़र आईडी मौजूदा सेशन से मेल नहीं खाता है, तो अपने ऐप्लिकेशन का मौजूदा सेशन खत्म करें और अनुरोध किए गए उपयोगकर्ता के तौर पर साइन इन करें.
मिलते-जुलते विषय
ऐप्लिकेशन में, Google Drive के यूज़र इंटरफ़ेस (यूआई) से एक ऐप्लिकेशन खोलने के अलावा, ऐप्लिकेशन में से कॉन्टेंट चुनने के लिए फ़ाइल पिकर भी दिख सकता है. ज़्यादा जानकारी के लिए, Google पिकर देखें.