REST Resource: permissions

• উৎস: অনুমতি
  • JSON উপস্থাপনা
• পদ্ধতি

উৎস: অনুমতি

একটি ফাইলের জন্য অনুমতি। একটি অনুমতি কোনো ব্যবহারকারী, গ্রুপ, ডোমেইন বা বিশ্বকে একটি ফাইল বা ফোল্ডার কাঠামোতে অ্যাক্সেস প্রদান করে। আরও তথ্যের জন্য, ফাইল, ফোল্ডার এবং ড্রাইভ শেয়ার দেখুন।

ডিফল্টরূপে, অনুমতির অনুরোধগুলি শুধুমাত্র কিছু নির্দিষ্ট ফিল্ড ফেরত দেয়। অনুমতির kind , ID , type এবং role সর্বদা ফেরত দেওয়া হয়। নির্দিষ্ট ফিল্ডগুলি পুনরুদ্ধার করতে, "নির্দিষ্ট ফিল্ডগুলি ফেরত দিন" দেখুন।

কিছু রিসোর্স মেথডের (যেমন permissions.update ) জন্য একটি permissionId প্রয়োজন হয়। কোনো ফাইল, ফোল্ডার বা শেয়ার্ড ড্রাইভের আইডি পেতে permissions.list মেথডটি ব্যবহার করুন।

JSON উপস্থাপনা

{ "id": string, "displayName": string, "type": string, "kind": string, "permissionDetails": [ { "permissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "photoLink": string, "emailAddress": string, "role": string, "allowFileDiscovery": boolean, "domain": string, "expirationTime": string, "teamDrivePermissionDetails": [ { "teamDrivePermissionType": string, "inheritedFrom": string, "role": string, "inherited": boolean } ], "deleted": boolean, "view": string, "pendingOwner": boolean, "inheritedPermissionsDisabled": boolean }

ক্ষেত্র
id	string শুধুমাত্র আউটপুট। এই অনুমতির আইডি। এটি অনুমতিগ্রহীতার জন্য একটি অনন্য শনাক্তকারী, এবং User রিসোর্সে permissionId হিসেবে প্রকাশিত হয়। আইডিগুলোকে অস্বচ্ছ মান হিসেবে বিবেচনা করা উচিত।
displayName	string শুধুমাত্র আউটপুট। এটি পারমিশনের ভ্যালুটির সুন্দর নাম। নিচে প্রতিটি ধরনের পারমিশনের কিছু উদাহরণ দেওয়া হলো: user - ব্যবহারকারীর পুরো নাম, যা তার গুগল অ্যাকাউন্টে সংজ্ঞায়িত করা আছে, যেমন "ডানা এ."। group - গুগল গ্রুপের নাম, যেমন "কোম্পানির প্রশাসকগণ"। domain - স্ট্রিং ডোমেইন নাম, যেমন "cymbalgroup.com"। anyone - কোনো displayName নেই।
type	string অনুদানগ্রহীতার ধরণ। সমর্থিত মূল্যবোধগুলোর মধ্যে অন্তর্ভুক্ত রয়েছে: user group domain anyone পারমিশন তৈরি করার সময়, যদি type user বা group হয়, তাহলে আপনাকে অবশ্যই সেই ইউজার বা গ্রুপের একটি emailAddress দিতে হবে। যদি type domain হয়, তাহলে আপনাকে অবশ্যই একটি domain দিতে হবে। যদি type anyone হয়, তাহলে কোনো অতিরিক্ত তথ্যের প্রয়োজন নেই।
kind	string শুধুমাত্র আউটপুট। এটি কী ধরনের রিসোর্স তা শনাক্ত করে। মান: নির্দিষ্ট স্ট্রিং "drive#permission" ।
permissionDetails[]	object শুধুমাত্র আউটপুট। এই আইটেমের অনুমতিগুলো উত্তরাধিকারসূত্রে প্রাপ্ত নাকি সরাসরি এই আইটেমটির উপর আরোপিত, তার বিস্তারিত বিবরণ।
permissionDetails[].permissionType	string শুধুমাত্র আউটপুট। এই ব্যবহারকারীর জন্য অনুমতির ধরণ। সমর্থিত মানগুলো হলো: file member
permissionDetails[].inheritedFrom	string শুধুমাত্র আউটপুট। যে আইটেম থেকে এই অনুমতিটি উত্তরাধিকারসূত্রে প্রাপ্ত হয়, তার আইডি। এটি শুধুমাত্র শেয়ার্ড ড্রাইভের আইটেমগুলোর জন্য পূরণ করা হয়।
permissionDetails[].role	string শুধুমাত্র আউটপুট। এই ব্যবহারকারীর প্রধান ভূমিকা। সমর্থিত মানগুলির মধ্যে রয়েছে: owner organizer fileOrganizer writer commenter reader আরও তথ্যের জন্য, ভূমিকা ও অনুমতিসমূহ দেখুন।
permissionDetails[].inherited	boolean শুধুমাত্র আউটপুট। এই অনুমতিটি উত্তরাধিকারসূত্রে প্রাপ্ত হবে কিনা। এই ক্ষেত্রটি সর্বদা পূরণ করা থাকে। এটি একটি শুধুমাত্র-আউটপুট ক্ষেত্র।
photoLink	string শুধুমাত্র আউটপুট। ব্যবহারকারীর প্রোফাইল ফটোর একটি লিঙ্ক, যদি উপলব্ধ থাকে।
emailAddress	string শুধুমাত্র আউটপুট। যে ব্যবহারকারী বা গোষ্ঠীর জন্য এই অনুমতিটি প্রযোজ্য, তাদের ইমেল ঠিকানা।
role	string এই অনুমতি দ্বারা প্রদত্ত ভূমিকা। সমর্থিত মানগুলির মধ্যে রয়েছে: owner organizer fileOrganizer writer commenter reader আরও তথ্যের জন্য, ভূমিকা ও অনুমতিসমূহ দেখুন।
allowFileDiscovery	boolean অনুমতিটি অনুসন্ধানের মাধ্যমে ফাইলটি খুঁজে পাওয়ার সুযোগ দেয় কিনা। এটি শুধুমাত্র domain বা anyone ধরনের অনুমতির ক্ষেত্রে প্রযোজ্য।
domain	string শুধুমাত্র আউটপুট। যে ডোমেইনটির জন্য এই অনুমতিটি প্রযোজ্য।
expirationTime	string যে সময়ে এই অনুমতির মেয়াদ শেষ হবে ( RFC 3339 তারিখ-সময় )। মেয়াদ শেষ হওয়ার সময়ের নিম্নলিখিত সীমাবদ্ধতা রয়েছে: এগুলো শুধুমাত্র ব্যবহারকারী এবং গ্রুপের অনুমতিতে সেট করা যায়। সময়টা অবশ্যই ভবিষ্যতে হতে হবে। সময়টি ভবিষ্যতের এক বছরের বেশি হতে পারে না।
teamDrivePermissionDetails[] (deprecated)	object এই আইটেমটি অপ্রচলিত! শুধুমাত্র আউটপুট। অপ্রচলিত: শুধুমাত্র আউটপুট। এর পরিবর্তে permissionDetails ব্যবহার করুন।
teamDrivePermissionDetails[] (deprecated) .teamDrivePermissionType (deprecated)	string অপ্রচলিত: শুধুমাত্র আউটপুট। এর পরিবর্তে permissionDetails/permissionType ব্যবহার করুন।
teamDrivePermissionDetails[] (deprecated) .inheritedFrom (deprecated)	string অপ্রচলিত: শুধুমাত্র আউটপুট। এর পরিবর্তে permissionDetails/inheritedFrom ব্যবহার করুন।
teamDrivePermissionDetails[] (deprecated) .role (deprecated)	string অপ্রচলিত: শুধুমাত্র আউটপুট। এর পরিবর্তে permissionDetails/role ব্যবহার করুন।
teamDrivePermissionDetails[] (deprecated) .inherited (deprecated)	boolean অপ্রচলিত: শুধুমাত্র আউটপুট। এর পরিবর্তে permissionDetails/inherited ব্যবহার করুন।
deleted	boolean শুধুমাত্র আউটপুট। এই অনুমতির সাথে যুক্ত অ্যাকাউন্টটি মুছে ফেলা হয়েছে কিনা। এই ফিল্ডটি শুধুমাত্র user বা group ধরনের অনুমতির ক্ষেত্রে প্রযোজ্য।
view	string এই অনুমতির জন্য ভিউ নির্দেশ করে। শুধুমাত্র সেইসব অনুমতির জন্য এটি পূরণ করা হয় যেগুলো কোনো ভিউয়ের অন্তর্গত। শুধুমাত্র published এবং metadata মানগুলোই সমর্থিত। published : অনুমতিটির ভূমিকা হলো publishedReader । metadata : আইটেমটি শুধুমাত্র metadata ভিউতে দেখা যায়, কারণ আইটেমটির অ্যাক্সেস সীমিত এবং স্কোপটির প্যারেন্টের উপর অন্তত রিড অ্যাক্সেস রয়েছে। metadata ভিউ শুধুমাত্র ফোল্ডারের ক্ষেত্রে সমর্থিত। আরও তথ্যের জন্য, ভিউজ দেখুন।
pendingOwner	boolean এই অনুমতির সাথে যুক্ত অ্যাকাউন্টটি একজন অপেক্ষমান মালিক কিনা। শুধুমাত্র সেইসব ফাইলের user -ধরনের অনুমতির জন্য এই তথ্যটি পূরণ করা হয়, যেগুলো কোনো শেয়ার্ড ড্রাইভে নেই।
inheritedPermissionsDisabled	boolean যখন true , তখন শুধুমাত্র সংগঠক, মালিক এবং আইটেমটিতে সরাসরি অনুমতি যুক্ত করা ব্যবহারকারীরাই এটি অ্যাক্সেস করতে পারবেন।

পদ্ধতি
create	কোনো ফাইল বা শেয়ার্ড ড্রাইভের জন্য অনুমতি তৈরি করে।
delete	একটি অনুমতি মুছে দেয়।
get	আইডি দ্বারা অনুমতি পায়।
list	কোনো ফাইল বা শেয়ার করা ড্রাইভের অনুমতিসমূহ তালিকাভুক্ত করে।
update	প্যাচ সেম্যান্টিকস ব্যবহার করে একটি পারমিশন আপডেট করে।