ऐक्सेस के लंबित अनुरोध मैनेज करना

ऐक्सेस का प्रस्ताव, अनुरोध करने वाले व्यक्ति की ओर से अनुमति देने वाले व्यक्ति को भेजा गया एक प्रस्ताव होता है. इसमें अनुरोध करने वाला व्यक्ति, अनुमति देने वाले व्यक्ति से किसी व्यक्ति को Google Drive में मौजूद किसी आइटम का ऐक्सेस देने के लिए कहता है.

अनुमति देने वाला व्यक्ति, Drive की फ़ाइलों के लिए ऐक्सेस के सभी ऐसे अनुरोधों की समीक्षा कर सकता है जिन पर अब तक कोई कार्रवाई नहीं की गई है. इसका मतलब है कि प्रोग्राम के हिसाब से ऐक्सेस के प्रस्तावों के लिए क्वेरी करके और फिर उन्हें हल करके, मंज़ूरी पाने की प्रोसेस को तेज़ किया जा सकता है. इससे मंज़ूरी देने वाला व्यक्ति, सभी प्रस्तावों को एक साथ देख सकता है.

Google Drive API, accessproposals संसाधन उपलब्ध कराता है. इससे, आपको ऐक्सेस के लिए मिले अनुरोधों को देखने और उन्हें स्वीकार या अस्वीकार करने में मदद मिलती है. accessproposals संसाधन के तरीके, फ़ाइलों, फ़ोल्डर, और शेयर की गई ड्राइव में मौजूद फ़ाइलों पर काम करते हैं. हालांकि, ये शेयर की गई ड्राइव पर काम नहीं करते.

ऐक्सेस के प्रस्तावों के लिए, ये शर्तें लागू होती हैं:

  • अनुरोध करने वाला व्यक्ति: वह व्यक्ति जो Drive आइटम को ऐक्सेस करने का अनुरोध करता है.
  • पाने वाला: अगर ऐक्सेस का प्रस्ताव स्वीकार कर लिया जाता है, तो यह वह उपयोगकर्ता होता है जिसे किसी फ़ाइल पर अतिरिक्त अनुमतियां मिलती हैं. कई बार, अनुरोध करने वाला और अनुरोध स्वीकार करने वाला एक ही व्यक्ति होता है. हालांकि, ऐसा हमेशा नहीं होता.
  • अनुमोदन देने वाला व्यक्ति: यह वह व्यक्ति होता है जिसके पास ऐक्सेस के अनुरोध को स्वीकार या अस्वीकार करने का अधिकार होता है. आम तौर पर, ऐसा इसलिए होता है, क्योंकि वे दस्तावेज़ के मालिक होते हैं या उनके पास दस्तावेज़ शेयर करने की अनुमति होती है.

फ़ील्ड पैरामीटर का इस्तेमाल करना

अगर आपको जवाब में दिखाए जाने वाले फ़ील्ड तय करने हैं, तो accessproposals रिसॉर्स के किसी भी तरीके के साथ fields सिस्टम पैरामीटर सेट किया जा सकता है. fields पैरामीटर को शामिल न करने पर, सर्वर उस तरीके के लिए फ़ील्ड का डिफ़ॉल्ट सेट दिखाता है. अलग-अलग फ़ील्ड वापस पाने के लिए, चुनिंदा फ़ील्ड वापस पाना लेख पढ़ें.

ऐक्सेस करने का कोई अनुरोध मिला हो

ऐक्सेस का सुझाव पाने के लिए, fileId और proposalId पाथ पैरामीटर के साथ accessproposals रिसॉर्स पर get तरीके का इस्तेमाल करें. अगर आपको प्रपोज़ल आईडी नहीं पता है, तो list तरीके का इस्तेमाल करके, ऐक्सेस के लिए लंबित प्रपोज़ल की सूची देखी जा सकती है.

ऐक्सेस के उन अनुरोधों की सूची जिन्हें मंज़ूरी मिलना बाकी है

Drive आइटम पर, ऐक्सेस के सभी लंबित प्रस्तावों को सूची में शामिल करने के लिए, accessproposals संसाधन पर list तरीके को कॉल करें. साथ ही, fileId पाथ पैरामीटर शामिल करें.

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

जवाब के मुख्य हिस्से में एक accessproposals ऑब्जेक्ट होता है. यह ऑब्जेक्ट, फ़ाइल पर ऐक्सेस के उन प्रस्तावों की सूची दिखाता है जिन्हें अब तक स्वीकार नहीं किया गया है.

accessproposals ऑब्जेक्ट में हर प्रस्ताव के बारे में जानकारी शामिल होती है. जैसे, अनुरोध करने वाला व्यक्ति, अनुरोध पाने वाला व्यक्ति, और अनुरोध करने वाले व्यक्ति ने जो मैसेज जोड़ा है वह. इसमें RoleAndView ऑब्जेक्ट भी शामिल होता है. यह ऑब्जेक्ट, अनुरोध करने वाले व्यक्ति के सुझाए गए role को view के साथ ग्रुप करता है. role दोहराया गया फ़ील्ड है. इसलिए, हर प्रपोज़ल के लिए एक से ज़्यादा वैल्यू मौजूद हो सकती हैं. उदाहरण के लिए, किसी प्रस्ताव में role=reader और view=published का RoleAndView ऑब्जेक्ट हो सकता है. साथ ही, सिर्फ़ role=writer वैल्यू वाला एक और RoleAndView ऑब्जेक्ट हो सकता है. ज़्यादा जानकारी के लिए, व्यू देखें.

ऐक्सेस के प्रस्तावों के पेज नंबर बदलने या उन्हें फ़िल्टर करने के लिए, यहां दिए गए क्वेरी पैरामीटर पास करें:

  • pageToken: यह एक पेज टोकन है, जो सूची बनाने के लिए किए गए पिछले कॉल से मिला है. अगला पेज पाने के लिए, यह टोकन दें.

  • pageSize: हर पेज पर, ऐक्सेस के अनुरोधों की ज़्यादा से ज़्यादा संख्या.

ऐक्सेस के लंबित प्रस्तावों को स्वीकार या अस्वीकार करना

Drive आइटम पर, ऐक्सेस के सभी लंबित अनुरोधों को हल करने के लिए, accessproposals संसाधन पर resolve तरीके को कॉल करें. साथ ही, fileId और proposalId पाथ पैरामीटर शामिल करें.

resolve तरीके में action क्वेरी पैरामीटर शामिल होता है. यह पैरामीटर, प्रपोज़ल पर की जाने वाली कार्रवाई के बारे में बताता है. Action ऑब्जेक्ट, प्रस्ताव की स्थिति में होने वाले बदलाव को ट्रैक करता है, ताकि हमें पता चल सके कि इसे स्वीकार किया जा रहा है या अस्वीकार किया जा रहा है.

resolve तरीके में, role और view के वैकल्पिक क्वेरी पैरामीटर भी शामिल होते हैं. सिर्फ़ writer, commenter, और reader भूमिकाओं के लिए यह सुविधा उपलब्ध है. अगर भूमिका नहीं बताई गई है, तो डिफ़ॉल्ट रूप से reader लागू हो जाती है. ज़्यादा जानकारी के लिए, भूमिकाएं और अनुमतियां देखें. sendNotification का एक और क्वेरी पैरामीटर, अनुरोध करने वाले व्यक्ति को ईमेल से सूचना भेजने की सुविधा देता है. यह सूचना तब भेजी जाती है, जब प्रस्ताव स्वीकार या अस्वीकार कर दिया जाता है.

list तरीके की तरह ही, प्रपोज़ल को स्वीकार करने वाले उपयोगकर्ताओं के पास फ़ाइल पर can_approve_access_proposals की सुविधा होनी चाहिए. capabilities के बारे में ज़्यादा जानकारी के लिए, फ़ाइल की सुविधाओं के बारे में जानकारी लेख पढ़ें.

प्रस्तावों को हल करने के लिए, Drive के संसाधन शेयर करने के उदाहरण में दिए गए पैटर्न का इस्तेमाल किया जाता है. अगर एक ही उपयोगकर्ता के लिए, अलग-अलग भूमिकाओं वाले कई प्रस्ताव हैं, तो इन बातों का ध्यान रखें:

  • अगर एक प्रस्ताव स्वीकार कर लिया जाता है और दूसरा अस्वीकार कर दिया जाता है, तो Drive आइटम पर स्वीकार की गई भूमिका लागू होती है.
  • अगर दोनों प्रस्तावों को एक ही समय पर स्वीकार कर लिया जाता है, तो ज़्यादा अनुमति वाले प्रस्ताव (उदाहरण के लिए, role=writer बनाम role=reader) को लागू किया जाता है. ऐक्सेस के दूसरे अनुरोध को आइटम से हटा दिया जाता है.

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