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

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

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

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

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

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

Drive API, files संसाधन के read-only resourceKey फ़ील्ड में किसी फ़ाइल की संसाधन कुंजी दिखाता है.

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

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

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

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