संसाधन कुंजियों का इस्तेमाल करके, लिंक से शेयर की गई Drive फ़ाइलों को ऐक्सेस करना

Google Drive में मौजूद फ़ाइलों और फ़ोल्डर को, Drive के यूज़र इंटरफ़ेस (यूआई) या Google Drive API की मदद से दूसरों के साथ शेयर किया जा सकता है. Drive से फ़ाइल शेयर करने पर, आपके पास यह तय करने का विकल्प होता है कि क्या लोग फ़ाइल में बदलाव कर सकते हैं, टिप्पणी कर सकते हैं या उसे सिर्फ़ देख सकते हैं.

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

लिंक के ज़रिए शेयर की गई Drive की फ़ाइल को सिर्फ़ वे उपयोगकर्ता ढूंढ सकते हैं जो type=user या type=group permissions संसाधन की वजह से, फ़ाइल को ऐक्सेस कर सकते हैं. सिर्फ़ type=domain या type=anyone अनुमति का इस्तेमाल करके, लिंक के ज़रिए शेयर की गई इन फ़ाइलों को ऐक्सेस करने वाले उपयोगकर्ताओं के अनुरोधों के लिए, संसाधन कुंजी की ज़रूरत पड़ सकती है.

अनुमतियों के बारे में ज़्यादा जानने के लिए, फ़ाइलें, फ़ोल्डर, और ड्राइव शेयर करना लेख पढ़ें. भूमिकाओं और हर भूमिका के लिए दी गई अनुमतियों की पूरी सूची देखने के लिए, भूमिकाएं और अनुमतियां लेख पढ़ें.

फ़ाइल से संसाधन कुंजी पढ़ना

Drive API, files संसाधन के सिर्फ़ पढ़ने के लिए उपलब्ध resourceKey फ़ील्ड पर, किसी फ़ाइल की संसाधन कुंजी दिखाता है.

अगर फ़ाइल, Drive का शॉर्टकट है, तो शॉर्टकट के टारगेट के लिए संसाधन कुंजी, सिर्फ़ पढ़ने के लिए उपलब्ध shortcutDetails.targetResourceKey फ़ील्ड पर दिखाई जाती है.

files संसाधन में मौजूद ऐसे फ़ील्ड जो यूआरएल दिखाते हैं, उनमें resourceKey भी शामिल होता है. जैसे, exportLinks, webContentLink, और webViewLink. Drive के यूज़र इंटरफ़ेस (यूआई) के साथ इंटिग्रेट होने वाले क्लाइंट, resourceKeys state पैरामीटर में भी इस्तेमाल कर सकते हैं. ज़्यादा जानकारी के लिए, फ़ाइलें डाउनलोड और एक्सपोर्ट करना लेख पढ़ें.

अनुरोध पर संसाधन कुंजी सेट करना

Drive API के अनुरोधों में रेफ़रंस के तौर पर इस्तेमाल की गई किसी भी फ़ाइल के लिए संसाधन कुंजियां, X-Goog-Drive-Resource-Keys एचटीटीपी हेडर पर सेट की जाती हैं.

Drive API के अनुरोध, X-Goog-Drive-Resource-Keys एचटीटीपी हेडर के साथ एक या उससे ज़्यादा संसाधन कुंजियां तय कर सकते हैं.

सिंटैक्स

हेडर पर, फ़ाइल आईडी और संसाधन कुंजी का पेयर, फ़ॉरवर्ड स्लैश (/) सेपरेटर का इस्तेमाल करके सेट किया जाता है. कॉमा (,) सेपरेटर का इस्तेमाल करके, फ़ाइल आईडी और संसाधन कुंजी के सभी पेयर को मिलाकर हेडर बनाया जाता है.

उदाहरण के लिए, फ़ाइल fileId1 को फ़ोल्डर fileId2 से फ़ोल्डर fileId3 में ले जाने के अनुरोध पर विचार करें. मान लें कि इन तीनों फ़ाइलों के लिए संसाधन कुंजियां, क्रमशः resourceKey1, resourceKey2, और resourceKey3 हैं. फ़ॉरवर्ड स्लैश और कॉमा सेपरेटर का इस्तेमाल करके, इन वैल्यू से बनाया गया हेडर यह है:

    X-Goog-Drive-Resource-Keys: fileId1/resourceKey1,fileId2/resourceKey2,fileId3/resourceKey3