একটি অ্যাক্সেস প্রস্তাব হল Google ড্রাইভ আইটেমে প্রাপককে অ্যাক্সেস দেওয়ার জন্য একটি অনুরোধকারীর কাছ থেকে একটি অনুমোদনকারীর কাছে একটি প্রস্তাব৷
একজন অনুমোদনকারী ড্রাইভ ফাইল জুড়ে সমস্ত অমীমাংসিত অ্যাক্সেস প্রস্তাব পর্যালোচনা এবং কাজ করতে পারে৷ এর অর্থ হল আপনি প্রোগ্রাম্যাটিকভাবে অ্যাক্সেস প্রস্তাবগুলির জন্য অনুসন্ধান করে এবং তারপরে সেগুলি সমাধান করে অনুমোদনের প্রক্রিয়াটিকে দ্রুততর করতে পারেন৷ এটি একটি অনুমোদনকারী দ্বারা প্রস্তাবগুলিকে সামগ্রিকভাবে দেখার অনুমতি দেয়।
Google ড্রাইভ API accessproposals প্রপোজাল সংস্থান সরবরাহ করে যাতে আপনি মুলতুবি থাকা অ্যাক্সেস প্রস্তাবগুলি দেখতে এবং সমাধান করতে পারেন৷ accessproposals রিসোর্সের পদ্ধতিগুলি ফাইল, ফোল্ডার, শেয়ার্ড ড্রাইভের মধ্যে থাকা ফাইলগুলিতে কাজ করে কিন্তু শেয়ার্ড ড্রাইভে নয় ৷
নিম্নলিখিত শর্তাদি প্রস্তাবগুলি অ্যাক্সেস করার জন্য নির্দিষ্ট:
- অনুরোধকারী : ব্যবহারকারী একটি ড্রাইভ আইটেম অ্যাক্সেস প্রস্তাব শুরু.
- প্রাপক : অ্যাক্সেস প্রস্তাব মঞ্জুর করা হলে একটি ফাইলে অতিরিক্ত অনুমতি গ্রহণকারী ব্যবহারকারী। অনেক সময় প্রাপক অনুরোধকারীর মতো কিন্তু সবসময় নয়।
- অনুমোদনকারী : অ্যাক্সেস প্রস্তাব অনুমোদন (বা অস্বীকার) করার জন্য দায়ী ব্যবহারকারী। এটি সাধারণত কারণ তারা নথির মালিক অথবা তাদের নথিটি ভাগ করার ক্ষমতা রয়েছে৷
ক্ষেত্র প্যারামিটার ব্যবহার করুন
আপনি যদি প্রতিক্রিয়াতে ফিরে আসার জন্য ক্ষেত্রগুলি নির্দিষ্ট করতে চান তবে আপনি accessproposals সংস্থানের যে কোনও পদ্ধতির সাথে fields সিস্টেম প্যারামিটার সেট করতে পারেন। আপনি যদি fields পরামিতি বাদ দেন, সার্ভারটি পদ্ধতির জন্য নির্দিষ্ট ক্ষেত্রগুলির একটি ডিফল্ট সেট প্রদান করে। বিভিন্ন ক্ষেত্র ফেরত দিতে, নির্দিষ্ট ক্ষেত্র ফেরত দেখুন।
একটি মুলতুবি অ্যাক্সেস প্রস্তাব পান
অ্যাক্সেস প্রপোজাল পেতে, fileId এবং proposalId পাথ প্যারামিটার সহ accessproposals রিসোর্সে get মেথড ব্যবহার করুন। আপনি যদি প্রস্তাব আইডি না জানেন, আপনি list পদ্ধতি ব্যবহার করে মুলতুবি অ্যাক্সেস প্রস্তাব তালিকাভুক্ত করতে পারেন।
মুলতুবি অ্যাক্সেস প্রস্তাব তালিকা
একটি ড্রাইভ আইটেমে সমস্ত মুলতুবি থাকা অ্যাক্সেস প্রস্তাবগুলি তালিকাভুক্ত করতে, accessproposals সংস্থানে list পদ্ধতিতে কল করুন এবং fileId পাথ প্যারামিটার অন্তর্ভুক্ত করুন৷
শুধুমাত্র একটি ফাইলের অনুমোদনকারীরা একটি ফাইলে মুলতুবি থাকা প্রস্তাবগুলি তালিকাভুক্ত করতে পারে। একজন অনুমোদনকারী হলেন একজন ব্যবহারকারী যার ফাইলে can_approve_access_proposals রয়েছে। অনুরোধকারী অনুমোদনকারী না হলে, একটি খালি তালিকা ফেরত দেওয়া হয়। capabilities সম্পর্কে আরও তথ্যের জন্য, ফাইলের ক্ষমতা বুঝতে দেখুন।
রেসপন্স বডিতে একটি accessproposals অবজেক্ট থাকে যা ফাইলে অমীমাংসিত অ্যাক্সেস প্রস্তাবগুলির একটি তালিকা উপস্থাপন করে।
accessproposals অবজেক্টে প্রতিটি প্রস্তাব সম্পর্কে তথ্য অন্তর্ভুক্ত থাকে যেমন অনুরোধকারী, প্রাপক এবং অনুরোধকারী যোগ করা বার্তা। এটিতে একটি RoleAndView অবজেক্টও রয়েছে যা অনুরোধকারীর প্রস্তাবিত role একটি view সহ দলবদ্ধ করে। যেহেতু role একটি পুনরাবৃত্ত ক্ষেত্র, তাই প্রতিটি প্রস্তাবের জন্য গুণিতক থাকতে পারে। উদাহরণ স্বরূপ, একটি প্রস্তাবে role=reader এবং view=published এর একটি RoleAndView অবজেক্ট থাকতে পারে, সাথে শুধুমাত্র role=writer মান সহ একটি অতিরিক্ত RoleAndView অবজেক্ট থাকতে পারে। আরও তথ্যের জন্য, ভিউ দেখুন।
পেজিনেশন কাস্টমাইজ করতে, বা ফিল্টার করার জন্য, প্রস্তাবগুলি অ্যাক্সেস করতে নিম্নলিখিত ক্যোয়ারী প্যারামিটারগুলি পাস করুন:
pageToken: একটি পৃষ্ঠা টোকেন, একটি পূর্ববর্তী তালিকা কল থেকে প্রাপ্ত। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এই টোকেনটি প্রদান করুন।pageSize: প্রতি পৃষ্ঠায় ফেরত দেওয়ার জন্য সর্বাধিক সংখ্যক অ্যাক্সেস প্রস্তাব।
মুলতুবি অ্যাক্সেস প্রস্তাব সমাধান
একটি ড্রাইভ আইটেমের সমস্ত মুলতুবি থাকা অ্যাক্সেস প্রস্তাবগুলি সমাধান করতে, accessproposals রিসোর্সে resolve পদ্ধতিতে কল করুন এবং fileId এবং proposalId পাথ প্যারামিটারগুলি অন্তর্ভুক্ত করুন।
resolve পদ্ধতিতে একটি action ক্যোয়ারী প্যারামিটার রয়েছে যা প্রস্তাবটি গ্রহণ করার জন্য পদক্ষেপকে নির্দেশ করে। Action অবজেক্ট প্রস্তাবটির রাষ্ট্রীয় পরিবর্তনকে ট্র্যাক করে যাতে আমরা জানি যে এটি গ্রহণ করা হচ্ছে বা অস্বীকার করা হচ্ছে।
resolve পদ্ধতিতে role এবং view ঐচ্ছিক ক্যোয়ারী প্যারামিটারও অন্তর্ভুক্ত রয়েছে। শুধুমাত্র সমর্থিত ভূমিকা হল writer , commenter এবং reader । ভূমিকা নির্দিষ্ট না থাকলে, এটি reader কাছে ডিফল্ট। আরও তথ্যের জন্য, ভূমিকা এবং অনুমতি দেখুন। sendNotification এর একটি অতিরিক্ত ঐচ্ছিক ক্যোয়ারী প্যারামিটার আপনাকে অনুরোধকারীকে একটি ইমেল বিজ্ঞপ্তি পাঠাতে দেয় যখন প্রস্তাবটি গৃহীত বা অস্বীকার করা হয়।
list পদ্ধতির মতোই, প্রস্তাবটি সমাধানকারী ব্যবহারকারীদের অবশ্যই ফাইলটিতে can_approve_access_proposals ক্ষমতা থাকতে হবে। capabilities সম্পর্কে আরও তথ্যের জন্য, ফাইলের ক্ষমতা বুঝতে দেখুন।
ড্রাইভ সংস্থান ভাগ করার জন্য দৃশ্যের অধীনে তালিকাভুক্ত একই নিদর্শনগুলি ব্যবহার করে প্রস্তাবগুলি সমাধান করা হয়৷ যদি একই ব্যবহারকারীর জন্য একাধিক প্রস্তাব থাকে, কিন্তু ভিন্ন ভূমিকা সহ, নিম্নলিখিতগুলি প্রযোজ্য:
- যদি একটি প্রস্তাব গৃহীত হয় এবং একটি প্রত্যাখ্যান করা হয়, গৃহীত ভূমিকা ড্রাইভ আইটেমের ক্ষেত্রে প্রযোজ্য।
- উভয় প্রস্তাব একই সময়ে গৃহীত হলে, উচ্চতর অনুমতি সহ প্রস্তাবটি প্রয়োগ করা হয় (উদাহরণস্বরূপ,
role=writerবনামrole=reader)। অন্যান্য অ্যাক্সেস প্রস্তাব আইটেম থেকে সরানো হয়.
resolve পদ্ধতিতে একটি প্রস্তাব পাঠানোর পরে, ভাগ করে নেওয়ার কাজটি সম্পূর্ণ হয়। সমাধান করা অ্যাক্সেস প্রস্তাব আর list পদ্ধতির মাধ্যমে ফেরত দেওয়া হয় না। একবার প্রস্তাবটি গৃহীত হলে, ব্যবহারকারীকে অবশ্যই একটি ফাইল বা ফোল্ডারে অনুমতি আপডেট করতে permissions সম্পদ ব্যবহার করতে হবে। আরও তথ্যের জন্য, আপডেট অনুমতি দেখুন।