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

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

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

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

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

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

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

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

files संसाधन के फ़ील्ड, जो यूआरएल दिखाते हैं, जैसे कि exportLinks, webContentLink, और webViewLink में resourceKey भी शामिल होता है. 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