ऐक्सेस का अनुरोध एक ऐसा अनुरोध है जो कोई अनुरोध करने वाला व्यक्ति, किसी अनुमति देने वाले व्यक्ति को Google Drive में मौजूद किसी आइटम का ऐक्सेस देने के लिए करता है.
अनुमति देने वाला व्यक्ति, Drive में मौजूद फ़ाइलों के लिए, ऐक्सेस के सभी ऐसे अनुरोधों की समीक्षा कर सकता है जिन पर कोई कार्रवाई नहीं की गई है. इसका मतलब है कि ऐक्सेस के अनुरोधों के लिए प्रोग्राम के ज़रिए क्वेरी करके और फिर उन्हें हल करके, अनुमति मिलने की प्रोसेस को तेज़ किया जा सकता है. इससे अनुमति देने वाला व्यक्ति, सभी अनुरोधों को एक साथ देख सकता है.
Google Drive API,
accessproposals संसाधन उपलब्ध कराता है. इससे, ऐक्सेस के लंबित अनुरोधों को देखा
और हल किया जा सकता है. accessproposals संसाधन के तरीके, फ़ाइलों, फ़ोल्डर, और शेयर की गई ड्राइव में मौजूद फ़ाइलों पर काम करते हैं. हालांकि, ये शेयर की गई ड्राइव पर काम नहीं करते.
ऐक्सेस के अनुरोधों के लिए, यहां दिए गए शब्द इस्तेमाल किए जाते हैं:
- अनुरोध करने वाला व्यक्ति: वह उपयोगकर्ता जो Drive में मौजूद किसी आइटम के ऐक्सेस का अनुरोध करता है.
- अनुरोध पाने वाला व्यक्ति: वह उपयोगकर्ता जिसे ऐक्सेस का अनुरोध स्वीकार होने पर, किसी फ़ाइल पर अतिरिक्त अनुमतियां मिलती हैं. कई बार, अनुरोध करने वाला और अनुरोध पाने वाला व्यक्ति एक ही होता है, लेकिन हमेशा ऐसा नहीं होता.
- अनुमति देने वाला व्यक्ति: वह उपयोगकर्ता जो ऐक्सेस के अनुरोध को स्वीकार (या अस्वीकार) करने के लिए ज़िम्मेदार होता है. आम तौर पर, ऐसा इसलिए होता है, क्योंकि वे दस्तावेज़ के मालिक होते हैं या उनके पास दस्तावेज़ शेयर करने की अनुमति होती है.
फ़ील्ड पैरामीटर का इस्तेमाल करना
अगर आपको जवाब में दिखाए जाने वाले फ़ील्ड तय करने हैं, तो
fields सिस्टम
पैरामीटर
को accessproposals संसाधन के किसी भी तरीके के साथ सेट किया जा सकता है. अगर fields पैरामीटर को छोड़ दिया जाता है, तो सर्वर, तरीके के हिसाब से फ़ील्ड का डिफ़ॉल्ट सेट दिखाता है. अलग-अलग फ़ील्ड दिखाने के लिए, खास फ़ील्ड दिखाना लेख पढ़ें.
ऐक्सेस का लंबित अनुरोध पाना
ऐक्सेस का अनुरोध पाने के लिए, get तरीके का इस्तेमाल accessproposals संसाधन पर fileId और proposalId
पाथ पैरामीटर के साथ करें. अगर आपको अनुरोध का आईडी नहीं पता है, तो ऐक्सेस के लंबित अनुरोधों की सूची
देखी जा सकती है list तरीके का इस्तेमाल करके.
ऐक्सेस के लंबित अनुरोधों की सूची देखना
Drive में मौजूद किसी आइटम के लिए, ऐक्सेस के सभी लंबित अनुरोधों की सूची देखने के लिए,
list संसाधन पर
accessproposals तरीके को कॉल करें और
fileId पाथ पैरामीटर शामिल करें.
किसी फ़ाइल के लिए, ऐक्सेस के लंबित अनुरोधों की सूची सिर्फ़ वे लोग देख सकते हैं जिनके पास उस फ़ाइल के लिए अनुमति देने का अधिकार है. अनुमति देने वाला व्यक्ति वह उपयोगकर्ता होता है जिसके पास फ़ाइल के लिए, can_approve_access_proposals की सुविधा होती है. अगर अनुरोध करने वाला व्यक्ति, अनुमति देने वाला व्यक्ति नहीं है, तो खाली सूची दिखाई जाती है. capabilities के बारे में ज़्यादा जानने के लिए, फ़ाइल की सुविधाओं के बारे में जानकारी लेख पढ़ें.
जवाब के मुख्य हिस्से में, रिस्पॉन्स बॉडी
में एक accessproposals ऑब्जेक्ट होता है. यह ऑब्जेक्ट, फ़ाइल के लिए ऐक्सेस के ऐसे अनुरोधों की सूची दिखाता है जिन पर कोई कार्रवाई नहीं की गई है.
accessproposals ऑब्जेक्ट में, हर अनुरोध के बारे में जानकारी शामिल होती है. जैसे, अनुरोध करने वाला व्यक्ति, अनुरोध पाने वाला व्यक्ति, और अनुरोध करने वाले व्यक्ति ने जो मैसेज जोड़ा है वह. इसमें
ऑब्जेक्ट भी शामिल होता हैRoleAndView. यह ऑब्जेक्ट, अनुरोध करने वाले व्यक्ति की ओर से सुझाई गई role को view के साथ ग्रुप करता है. role एक दोहराया गया फ़ील्ड है. इसलिए, हर अनुरोध के लिए एक से ज़्यादा भूमिकाएं हो सकती हैं. उदाहरण के लिए, किसी अनुरोध में role=reader और view=published का RoleAndView ऑब्जेक्ट हो सकता है. इसके अलावा, सिर्फ़ role=writer वैल्यू वाला एक और RoleAndView ऑब्जेक्ट भी हो सकता है. ज़्यादा जानकारी के लिए, व्यू लेख पढ़ें.
ऐक्सेस के अनुरोधों के लिए, पेज नंबर डालने की सुविधा को पसंद के मुताबिक बनाने या उन्हें फ़िल्टर करने के लिए, ये क्वेरी पैरामीटर पास करें:
pageToken: यह पेज टोकन, सूची के लिए पहले किए गए कॉल से मिलता है. अगला पेज पाने के लिए, यह टोकन डालें.pageSize: हर पेज पर, ऐक्सेस के ज़्यादा से ज़्यादा कितने अनुरोध दिखाए जाने चाहिए.
ऐक्सेस के लंबित अनुरोधों को हल करना
Drive में मौजूद किसी आइटम के लिए, ऐक्सेस के सभी लंबित अनुरोधों को हल करने के लिए, resolve तरीके को accessproposals संसाधन पर कॉल करें और fileId और proposalId पाथ पैरामीटर शामिल करें.
resolve तरीके में, action क्वेरी पैरामीटर शामिल होता है. इससे पता चलता है कि अनुरोध पर क्या कार्रवाई करनी है.
Action ऑब्जेक्ट, अनुरोध के स्टेटस में हुए बदलाव को ट्रैक करता है. इससे हमें पता चलता है कि अनुरोध स्वीकार किया गया है या अस्वीकार.
resolve तरीके में, role और view के वैकल्पिक क्वेरी पैरामीटर भी शामिल होते हैं. सिर्फ़ writer, commenter, और reader की भूमिकाएं काम करती हैं. अगर भूमिका तय नहीं की जाती है, तो डिफ़ॉल्ट रूप से reader की भूमिका लागू होती है. ज़्यादा जानकारी के लिए, भूमिकाएं
और अनुमतियां लेख पढ़ें. sendNotification का एक और वैकल्पिक क्वेरी पैरामीटर, अनुरोध स्वीकार या अस्वीकार होने पर, अनुरोध करने वाले व्यक्ति को ईमेल से सूचना भेजने की अनुमति देता है.
list तरीके की तरह ही, अनुरोध को हल करने वाले लोगों के पास फ़ाइल के लिए, can_approve_access_proposals की सुविधा होनी चाहिए. capabilities के बारे में ज़्यादा जानने के लिए, फ़ाइल की सुविधाओं के बारे में जानकारी लेख पढ़ें.
अनुरोधों को हल करने के लिए, Drive के संसाधनों को शेयर करने के अलग-अलग तरीके इस्तेमाल किए जाते हैं. इनकी जानकारी, Drive के संसाधनों को शेयर करने के अलग-अलग तरीके लेख में दी गई है. अगर एक ही उपयोगकर्ता के लिए, अलग-अलग भूमिकाओं वाले कई अनुरोध किए गए हैं, तो ये नियम लागू होते हैं:
- अगर एक अनुरोध स्वीकार किया जाता है और एक अस्वीकार, तो Drive में मौजूद आइटम पर, स्वीकार की गई भूमिका लागू होती है.
- अगर दोनों अनुरोध एक ही समय पर स्वीकार किए जाते हैं, तो ज़्यादा अनुमति वाला अनुरोध लागू होता है. उदाहरण के लिए,
role=writerबनामrole=reader. ऐक्सेस का दूसरा अनुरोध, आइटम से हटा दिया जाता है.
resolve तरीके से अनुरोध भेजने के बाद, शेयर करने की कार्रवाई पूरी हो जाती है. ऐक्सेस का हल किया गया अनुरोध, list तरीके से अब नहीं दिखाया जाता. अनुरोध स्वीकार होने के बाद, उपयोगकर्ता को किसी फ़ाइल या
फ़ोल्डर की अनुमतियां अपडेट करने के लिए, permissions संसाधन का इस्तेमाल करना होगा. ज़्यादा जानकारी के लिए, अनुमतियां
अपडेट करना लेख पढ़ें.