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