जब कोई उपयोगकर्ता कोई फ़ाइल चुनता है और Drive के यूज़र इंटरफ़ेस (यूआई) के "इसमें खोलें" मेन्यू आइटम पर क्लिक करता है, तो Drive उपयोगकर्ता को उस ऐप्लिकेशन के Open यूआरएल पर रीडायरेक्ट करता है. यह यूआरएल, Drive के यूज़र इंटरफ़ेस (यूआई) के इंटिग्रेशन को कॉन्फ़िगर करना में बताया गया है.
अगर आपने Drive के यूज़र इंटरफ़ेस (यूआई) के इंटिग्रेशन को कॉन्फ़िगर करते समय, "इंपोर्ट किया जा रहा है" बॉक्स पर सही का निशान लगाया है, तो उपयोगकर्ता ऐप्लिकेशन के हिसाब से और Google Workspace की फ़ाइलों का कॉम्बिनेशन चुन सकता है. Drive के यूज़र इंटरफ़ेस (यूआई) के इंटिग्रेशन को कॉन्फ़िगर करते समय, ऐप्लिकेशन के हिसाब से फ़ाइलों को "डिफ़ॉल्ट MIME टाइप" और "डिफ़ॉल्ट फ़ाइल एक्सटेंशन" फ़ील्ड में दिखाया जाता है. वहीं, Google Workspace की फ़ाइलों को "सेकंडरी MIME टाइप" और "सेकंडरी फ़ाइल एक्सटेंशन" फ़ील्ड में दिखाया जाता है.
उपयोगकर्ता जिस फ़ाइल को खोलना चाहता है उसके लिए, Drive आपके तय किए गए डिफ़ॉल्ट और दूसरे MIME टाइप के साथ MIME टाइप की जांच करता है:
"डिफ़ॉल्ट MIME टाइप" फ़ील्ड में बताए गए MIME टाइप के लिए, फ़ाइल आईडी को आपके ऐप्लिकेशन पर भेजा जाता है. ऐप्लिकेशन के हिसाब से फ़ाइलों को मैनेज करने के तरीके के बारे में जानने के लिए, ऐप्लिकेशन के हिसाब से दस्तावेज़ों के लिए, Open URL को मैनेज करना लेख पढ़ें.
"सेकंडरी MIME टाइप" फ़ील्ड में तय किए गए MIME टाइप के लिए, Drive का यूज़र इंटरफ़ेस (यूआई) एक डायलॉग बॉक्स दिखाता है. इसमें उपयोगकर्ता से पूछा जाता है कि Google Workspace फ़ाइल को किस फ़ाइल टाइप में बदलना है. उदाहरण के लिए, अगर आपने Drive के यूज़र इंटरफ़ेस (यूआई) में कोई Google Docs फ़ाइल चुनी और "सेकंडरी एमआईएमई टाइप" फ़ील्ड यह सुझाव देता है कि आपके ऐप्लिकेशन पर टेक्स्ट/सादा या ऐप्लिकेशन/पीडीएफ़ काम करता है, तो Drive के यूज़र इंटरफ़ेस (यूआई) से उपयोगकर्ता से पूछा जाता है कि उसे प्लेन टेक्स्ट या PDF फ़ॉर्मैट में बदलना है या नहीं.
Google Workspace फ़ाइलों को मैनेज करने के तरीके के बारे में जानने के लिए, Google Workspace दस्तावेज़ों के लिए, ओपन यूआरएल मैनेज करना लेख पढ़ें. Google Workspace के दस्तावेज़ों और एमआईएमई टाइप के कन्वर्ज़न फ़ॉर्मैट की सूची देखने के लिए, 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 के तौर पर पार्स करना होगा.
उपयोगकर्ता और नए इवेंट
Drive ऐप्लिकेशन को "इसकी मदद से खोलें" इवेंट को संभावित साइन-इन के तौर पर लेना चाहिए. कुछ उपयोगकर्ताओं के पास एक से ज़्यादा खाते हो सकते हैं. इसलिए, हो सकता है कि state
पैरामीटर में मौजूद यूज़र आईडी, मौजूदा सेशन से मेल न खाए. अगर state
पैरामीटर में मौजूद User-ID, मौजूदा सेशन से मेल नहीं खाता है, तो अपने ऐप्लिकेशन के लिए मौजूदा सेशन को खत्म करें और अनुरोध किए गए उपयोगकर्ता के तौर पर साइन इन करें.
मिलते-जुलते विषय
Google Drive के यूज़र इंटरफ़ेस (यूआई) से किसी ऐप्लिकेशन को खोलने के अलावा, ऐप्लिकेशन में कॉन्टेंट चुनने के लिए फ़ाइल पिकर भी दिखाया जा सकता है. ज़्यादा जानकारी के लिए, Google पिकर देखें.