গুগল ড্রাইভের প্রতিটি ফাইল, ফোল্ডার এবং শেয়ার করা ড্রাইভের সাথে সংশ্লিষ্ট permissions রিসোর্স থাকে। প্রতিটি রিসোর্স একটি নির্দিষ্ট type ( user , group , domain , anyone ) এবং role ( owner , organizer , fileOrganizer , writer , commenter , reader ) জন্য পারমিশন চিহ্নিত করে। উদাহরণস্বরূপ, একটি ফাইলের এমন একটি পারমিশন থাকতে পারে যা একজন নির্দিষ্ট ইউজারকে ( type=user ) শুধুমাত্র পড়ার (রিড-অনলি) অ্যাক্সেস ( role=reader ) দেয়, যেখানে অন্য একটি পারমিশন একটি নির্দিষ্ট গ্রুপের ( type=group ) সদস্যদের ফাইলটিতে কমেন্ট যোগ করার ( role=commenter ) ক্ষমতা দেয়।
ভূমিকাগুলির সম্পূর্ণ তালিকা এবং প্রতিটি দ্বারা অনুমোদিত ক্রিয়াকলাপগুলির জন্য, ভূমিকা এবং অনুমতিগুলি দেখুন।
অনুমতি কীভাবে কাজ করে
একটি ফোল্ডারের অনুমতি তালিকা নিচের দিকে সঞ্চারিত হয়। সমস্ত চাইল্ড ফাইল এবং ফোল্ডার প্যারেন্ট থেকে অনুমতি উত্তরাধিকার সূত্রে পায়। যখনই অনুমতি বা স্তরবিন্যাস পরিবর্তন করা হয়, তখন এই সঞ্চারণ প্রক্রিয়াটি সমস্ত নেস্টেড ফোল্ডারের মধ্যে পুনরাবৃত্তিমূলকভাবে ঘটে। উদাহরণস্বরূপ, যদি একটি ফোল্ডারে কোনো ফাইল থাকে এবং সেই ফোল্ডারটিকে পরে অন্য একটি ফোল্ডারের মধ্যে সরানো হয়, তবে নতুন ফোল্ডারের অনুমতিগুলো ফাইলটিতেও সঞ্চারিত হয়। যদি নতুন ফোল্ডারটি ফাইল ব্যবহারকারীকে "লেখক"-এর মতো কোনো নতুন ভূমিকা প্রদান করে, তবে এটি তার পুরানো ভূমিকাটিকে বাতিল করে দেয়।
বিপরীতভাবে, যদি কোনো ফাইল একটি ফোল্ডার থেকে role=writer উত্তরাধিকার সূত্রে পায় এবং সেটিকে 'reader' ভূমিকা প্রদানকারী অন্য একটি ফোল্ডারে সরানো হয়, তাহলে ফাইলটি এখন role=reader উত্তরাধিকার সূত্রে পাবে।
কোনো আইটেম থেকে উত্তরাধিকারসূত্রে প্রাপ্ত অনুমতি সরানো বা কমানো যায় না। এর পরিবর্তে, যে প্যারেন্ট থেকে এই অনুমতিগুলো এসেছে, সেখানে তা সামঞ্জস্য করতে হবে অথবা হায়ারার্কির কোনো ফোল্ডারে সীমিত অ্যাক্সেস সেটিংটি সক্রিয় করতে হবে।
কোনো আইটেমের উত্তরাধিকারসূত্রে প্রাপ্ত অনুমতি বাড়ানো যেতে পারে। যদি কোনো চাইল্ডের অনুমতি বাড়ানো হয়, তবে প্যারেন্টের অনুমতি পরিবর্তন করলেও চাইল্ডের অনুমতির উপর কোনো প্রভাব পড়ে না, যদি না নতুন প্যারেন্টের অনুমতি চাইল্ডের অনুমতির চেয়ে বেশি হয়।
একই ফাইলে একাধিক অনুমতি প্রয়োগ করা সমর্থিত নয়। শুধুমাত্র সর্বশেষ আপডেটটিই প্রয়োগ করা হয়।
ফাইলের ক্ষমতা বুঝুন
permissions রিসোর্সটি চূড়ান্তভাবে কোনো ফাইল বা ফোল্ডারে বর্তমান ব্যবহারকারীর কোনো কাজ করার ক্ষমতা নির্ধারণ করে না। এর পরিবর্তে, files রিসোর্সটিতে বুলিয়ান capabilities ফিল্ডের একটি সংগ্রহ থাকে, যা নির্দেশ করে যে কোনো ফাইল বা ফোল্ডারে কোনো কাজ করা যাবে কি না। গুগল ড্রাইভ এপিআই, ফাইল বা ফোল্ডারটির সাথে যুক্ত বর্তমান ব্যবহারকারীর permissions রিসোর্সের উপর ভিত্তি করে এই ফিল্ডগুলো সেট করে।
উদাহরণস্বরূপ, যখন অ্যালেক্স আপনার অ্যাপে লগ ইন করে একটি ফাইল শেয়ার করার চেষ্টা করে, তখন ফাইলটির উপর অ্যালেক্সের রোলের অনুমতি আছে কিনা তা যাচাই করা হয়। যদি রোলটি তাকে ফাইলটি শেয়ার করার অনুমতি দেয়, তবে ফাইলটির সাথে সম্পর্কিত capabilities , যেমন canShare , রোলের সাপেক্ষে সেট করা হয়। যদি অ্যালেক্স ফাইলটি শেয়ার করতে চায়, তবে আপনার অ্যাপ capabilities পরীক্ষা করে নিশ্চিত করে যে canShare true তে সেট করা আছে।
ফাইল ক্ষমতা পান
যখন আপনার অ্যাপ কোনো ফাইল খোলে, তখন এটির উচিত ফাইলটির ক্যাপাবিলিটি পরীক্ষা করা এবং বর্তমান ব্যবহারকারীর অনুমতি অনুযায়ী UI রেন্ডার করা। উদাহরণস্বরূপ, যদি ব্যবহারকারীর ফাইলটিতে canComment ক্যাপাবিলিটি না থাকে, তাহলে UI-তে মন্তব্য করার ক্ষমতা নিষ্ক্রিয় করে দেওয়া উচিত।
সক্ষমতা যাচাই করতে, files রিসোর্সের get মেথডটি fileId পাথ প্যারামিটার এবং fields প্যারামিটারটি capabilities ফিল্ডে সেট করে কল করুন। fields প্যারামিটার ব্যবহার করে ফিল্ড রিটার্ন করার বিষয়ে আরও তথ্যের জন্য, `Return specific fields` দেখুন।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে ব্যবহারকারীর অনুমতি যাচাই করতে হয়। প্রতিক্রিয়াটি ফাইলটির উপর ব্যবহারকারীর থাকা ক্ষমতার একটি তালিকা ফেরত দেয়। প্রতিটি ক্ষমতা ব্যবহারকারীর গ্রহণ করতে পারা একটি সুনির্দিষ্ট কাজের সাথে সম্পর্কিত। কিছু ফিল্ড শুধুমাত্র শেয়ার করা ড্রাইভের আইটেমগুলির জন্য পূরণ করা হয়।
অনুরোধ
GET https://www.googleapis.com/drive/v3/files/FILE_ID?fields=capabilitiesপ্রতিক্রিয়া
{ "capabilities": { "canAcceptOwnership": false, "canAddChildren": false, "canAddMyDriveParent": false, "canChangeCopyRequiresWriterPermission": true, "canChangeItemDownloadRestriction": true, "canChangeSecurityUpdateEnabled": false, "canChangeViewersCanCopyContent": true, "canComment": true, "canCopy": true, "canDelete": true, "canDisableInheritedPermissions": false, "canDownload": true, "canEdit": true, "canEnableInheritedPermissions": true, "canListChildren": false, "canModifyContent": true, "canModifyContentRestriction": true, "canModifyEditorContentRestriction": true, "canModifyOwnerContentRestriction": true, "canModifyLabels": true, "canMoveChildrenWithinDrive": false, "canMoveItemIntoTeamDrive": true, "canMoveItemOutOfDrive": true, "canMoveItemWithinDrive": true, "canReadLabels": true, "canReadRevisions": true, "canRemoveChildren": false, "canRemoveContentRestriction": false, "canRemoveMyDriveParent": true, "canRename": true, "canShare": true, "canTrash": true, "canUntrash": true } }
ড্রাইভ রিসোর্স শেয়ার করার দৃশ্যকল্প
পাঁচ ধরনের শেয়ারিং সিনারিও রয়েছে:
My Drive-এ কোনো ফাইল শেয়ার করতে হলে, ব্যবহারকারীর
role=writerঅথবাrole=ownerথাকতে হবে।যদি ফাইলটির জন্য
writersCanShareবুলিয়ান মানfalseসেট করা থাকে, তাহলে ব্যবহারকারীরrole=ownerথাকতে হবে।যদি
role=writerথাকা ব্যবহারকারীর একটি নির্দিষ্ট মেয়াদ ও সময় দ্বারা নিয়ন্ত্রিত অস্থায়ী অ্যাক্সেস থাকে, তবে তিনি ফাইলটি শেয়ার করতে পারবেন না। আরও তথ্যের জন্য, `আইটেম অ্যাক্সেস সীমিত করতে একটি মেয়াদ শেষ হওয়ার তারিখ সেট করুন` দেখুন।
My Drive-এ কোনো ফোল্ডার শেয়ার করতে হলে, ব্যবহারকারীর
role=writerঅথবাrole=ownerথাকতে হবে।যদি ফাইলটির জন্য
writersCanShareবুলিয়ান মানfalseসেট করা থাকে, তাহলে ব্যবহারকারীর অবশ্যই আরও উদারrole=ownerথাকতে হবে।শুধুমাত্র
role=readerযুক্ত ফোল্ডারগুলিতেই অস্থায়ী অ্যাক্সেস (যা একটি মেয়াদ শেষ হওয়ার তারিখ এবং সময় দ্বারা নিয়ন্ত্রিত) অনুমোদিত। আরও তথ্যের জন্য, আইটেম অ্যাক্সেস সীমিত করতে একটি মেয়াদ শেষ হওয়ার তারিখ সেট করুন দেখুন।
শেয়ার্ড ড্রাইভে কোনো ফাইল শেয়ার করতে হলে, ব্যবহারকারীর অবশ্যই
role=writer,role=fileOrganizer, অথবাrole=organizerথাকতে হবে।-
writersCanShareসেটিংটি শেয়ার করা ড্রাইভের আইটেমগুলোর ক্ষেত্রে প্রযোজ্য নয়। এটিকে এমনভাবে বিবেচনা করা হয় যেন এটি সর্বদা `trueসেট করা থাকে।
-
শেয়ার্ড ড্রাইভে কোনো ফোল্ডার শেয়ার করতে হলে, ব্যবহারকারীর
role=organizerথাকতে হবে।- যদি কোনো শেয়ার করা ড্রাইভে
sharingFoldersRequiresOrganizerPermissionবিধিনিষেধটিfalseএ সেট করা থাকে, তাহলেrole=fileOrganizerথাকা ব্যবহারকারীরা সেই শেয়ার করা ড্রাইভে ফোল্ডার শেয়ার করতে পারবেন।
- যদি কোনো শেয়ার করা ড্রাইভে
শেয়ার্ড ড্রাইভের সদস্যপদ পরিচালনা করতে হলে ব্যবহারকারীর
role=organizerথাকতে হবে। শুধুমাত্র ব্যবহারকারী এবং গ্রুপই শেয়ার্ড ড্রাইভের সদস্য হতে পারে।
ফিল্ড প্যারামিটার ব্যবহার করুন
রেসপন্সে কোন ফিল্ডগুলো ফেরত আসবে তা যদি আপনি নির্দিষ্ট করে দিতে চান, তাহলে আপনি permissions রিসোর্সের যেকোনো মেথডের সাথে fields সিস্টেম প্যারামিটারটি সেট করতে পারেন। আপনি যদি fields প্যারামিটারটি বাদ দেন, তাহলে সার্ভার মেথডটির জন্য নির্দিষ্ট কিছু ডিফল্ট ফিল্ড ফেরত দেবে। উদাহরণস্বরূপ, ' list ' মেথডটি প্রতিটি ফাইলের জন্য শুধুমাত্র ' id ', type ', kind ' এবং role ফিল্ডগুলো ফেরত দেয়। ভিন্ন ফিল্ড ফেরত দেওয়ার জন্য, 'Return specific fields' দেখুন।
একটি অনুমতি তৈরি করুন
অনুমতি তৈরি করার সময় নিম্নলিখিত দুটি ক্ষেত্র আবশ্যক:
type:typeঅনুমতির পরিধি (user,group,domain, বাanyone) চিহ্নিত করে।type=userযুক্ত অনুমতি একজন নির্দিষ্ট ব্যবহারকারীর জন্য প্রযোজ্য, অন্যদিকেtype=domainযুক্ত অনুমতি একটি নির্দিষ্ট ডোমেইনের সকলের জন্য প্রযোজ্য।role): 'roleফিল্ডটি শনাক্ত করে যেtypeকোন কোন অপারেশন সম্পাদন করতে পারে। উদাহরণস্বরূপ,type=userএবংrole=readerসহ একটি অনুমতি একজন নির্দিষ্ট ব্যবহারকারীকে ফাইল বা ফোল্ডারে শুধুমাত্র-পঠন (read-only) অ্যাক্সেস দেয়। অথবা,type=domainএবংrole=commenterসহ একটি অনুমতি ডোমেইনের প্রত্যেককে একটি ফাইলে মন্তব্য যোগ করার সুযোগ দেয়। ভূমিকা এবং প্রতিটি দ্বারা অনুমোদিত অপারেশনগুলির একটি সম্পূর্ণ তালিকার জন্য, 'ভূমিকা এবং অনুমতি' (Roles and permissions) দেখুন।
যখন আপনি type=user বা type=group উল্লেখ করে কোনো পারমিশন তৈরি করেন, তখন নির্দিষ্ট ব্যবহারকারী বা গ্রুপকে পারমিশনটির সাথে যুক্ত করার জন্য আপনাকে অবশ্যই একটি emailAddress প্রদান করতে হবে।
যখন আপনি type=domain সহ কোনো পারমিশন তৈরি করেন, তখন একটি নির্দিষ্ট ডোমেইনকে পারমিশনটির সাথে সংযুক্ত করার জন্য আপনাকে অবশ্যই একটি domain প্রদান করতে হবে।
একটি অনুমতি তৈরি করতে:
- সংশ্লিষ্ট ফাইল বা ফোল্ডারের জন্য,
permissionsরিসোর্সের `createমেথডে `fileIdপাথ প্যারামিটারটি ব্যবহার করুন। - অনুরোধের মূল অংশে
typeএবংroleউল্লেখ করুন। - যদি
type=userবাtype=group, তাহলে একটিemailAddressদিন। যদিtype=domain, তাহলে একটিdomainদিন।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি পারমিশন তৈরি করতে হয়। প্রতিক্রিয়াটি একটি permissions রিসোর্সের ইনস্ট্যান্স ফেরত দেয়, যার মধ্যে নির্ধারিত permissionId অন্তর্ভুক্ত থাকে।
অনুরোধ
POST https://www.googleapis.com/drive/v3/files/FILE_ID/permissions{ "requests": [ { "type": "user", "role": "commenter", "emailAddress": "alex@altostrat.com" } ] }
প্রতিক্রিয়া
{
"kind": "drive#permission",
"id": "PERMISSION_ID",
"type": "user",
"role": "commenter"
}লক্ষ্য দর্শক ব্যবহার করুন
টার্গেট অডিয়েন্স হলো বিভিন্ন গোষ্ঠী—যেমন বিভাগ বা টিম—যাদেরকে আপনি ব্যবহারকারীদেরকে তাদের আইটেম শেয়ার করার জন্য সুপারিশ করতে পারেন। আপনি ব্যবহারকারীদেরকে আপনার পুরো প্রতিষ্ঠানের পরিবর্তে আরও নির্দিষ্ট বা সীমিত কোনো অডিয়েন্সের সাথে আইটেম শেয়ার করতে উৎসাহিত করতে পারেন। টার্গেট অডিয়েন্স আপনাকে আপনার ডেটার নিরাপত্তা ও গোপনীয়তা উন্নত করতে সাহায্য করতে পারে এবং ব্যবহারকারীদের জন্য যথাযথভাবে শেয়ার করা সহজ করে তোলে। আরও তথ্যের জন্য, ‘টার্গেট অডিয়েন্স সম্পর্কে’ দেখুন।
টার্গেট অডিয়েন্স ব্যবহার করতে:
গুগল অ্যাডমিন কনসোলে, > ডিরেক্টরি > টার্গেট অডিয়েন্স- এ যান।
এই কাজটি করার জন্য আপনাকে অবশ্যই সুপার অ্যাডমিনিস্ট্রেটর অধিকার সম্পন্ন একটি অ্যাকাউন্ট দিয়ে সাইন ইন করতে হবে।
টার্গেট অডিয়েন্স তালিকায় , টার্গেট অডিয়েন্সের নামে ক্লিক করুন। একটি টার্গেট অডিয়েন্স তৈরি করতে, ‘একটি টার্গেট অডিয়েন্স তৈরি করুন’ দেখুন।
টার্গেট অডিয়েন্স URL:
https://admin.google.com/ac/targetaudiences/ IDথেকে অনন্য আইডিটি কপি করুন।type=domainসহ একটি পারমিশন তৈরি করুন এবংdomainফিল্ডটিID .audience.googledomains.com-এ সেট করুন।
ব্যবহারকারীরা লক্ষ্য দর্শকদের সাথে কীভাবে যোগাযোগ করে তা দেখতে, লিঙ্ক শেয়ারিংয়ের ব্যবহারকারীর অভিজ্ঞতা দেখুন।
অনুমতি নিন
অনুমতি পেতে, fileId এবং permissionId পাথ প্যারামিটারসহ permissions রিসোর্সের ` get মেথডটি ব্যবহার করুন। যদি আপনি অনুমতি আইডি না জানেন, তবে ` list মেথড ব্যবহার করে সমস্ত অনুমতির তালিকা দেখতে পারেন।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে আইডি দ্বারা অনুমতি পাওয়া যায়। প্রতিক্রিয়াটি একটি permissions রিসোর্সের ইনস্ট্যান্স ফেরত দেয়।
অনুরোধ
GET https://www.googleapis.com/drive/v3/files/FILE_ID/permissionsPERMISSION_ID
প্রতিক্রিয়া
{
"kind": "drive#permissionList",
"permissions": [
{
"kind": "drive#permission",
"id": "PERMISSION_ID",
"type": "user",
"role": "commenter"
}
]
}সমস্ত অনুমতি তালিকাভুক্ত করুন
কোনো ফাইল, ফোল্ডার বা শেয়ার্ড ড্রাইভের অনুমতিগুলো তালিকাভুক্ত করতে, fileId পাথ প্যারামিটারসহ permissions রিসোর্সের ` list মেথডটি ব্যবহার করুন।
পেজিনেশন কাস্টমাইজ করতে বা পারমিশন ফিল্টার করতে নিম্নলিখিত কোয়েরি প্যারামিটারগুলো পাস করুন:
pageSize: প্রতি পৃষ্ঠায় ফেরত দেওয়া অনুমতির সর্বোচ্চ সংখ্যা। শেয়ার্ড ড্রাইভের ফাইলগুলির জন্য এটি সেট করা না থাকলে, সর্বাধিক ১০০টি ফলাফল ফেরত দেওয়া হয়। শেয়ার্ড ড্রাইভে নেই এমন ফাইলগুলির জন্য এটি সেট করা না থাকলে, সম্পূর্ণ তালিকাটি ফেরত দেওয়া হয়।pageToken: পূর্ববর্তী তালিকা আহ্বান থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এই টোকেনটি প্রদান করুন।supportsAllDrives: অনুরোধকারী অ্যাপটি My Drives এবং শেয়ার করা ড্রাইভ উভয়কেই সমর্থন করে কিনা।useDomainAdminAccess: ডোমেইন অ্যাডমিনিস্ট্রেটর হিসেবে অনুরোধটি পাঠানোর জন্য এটিকে 'trueসেট করুন। যদিfileIdপ্যারামিটারটি কোনো শেয়ার্ড ড্রাইভকে নির্দেশ করে এবং অনুরোধকারী সেই ডোমেইনের অ্যাডমিনিস্ট্রেটর হন, যে ডোমেইনের অন্তর্ভুক্ত শেয়ার্ড ড্রাইভটি। আরও তথ্যের জন্য, 'ডোমেইন অ্যাডমিনিস্ট্রেটর হিসেবে শেয়ার্ড ড্রাইভ পরিচালনা' দেখুন।includePermissionsForView: রেসপন্সে অন্তর্ভুক্ত করার জন্য অতিরিক্ত ভিউটির পারমিশনসমূহ। শুধুমাত্রpublishedপারমিশন সমর্থিত।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে সমস্ত অনুমতি পাওয়া যায়। প্রতিক্রিয়াটি একটি ফাইল, ফোল্ডার বা শেয়ার্ড ড্রাইভের জন্য অনুমতির একটি তালিকা ফেরত দেয়।
অনুরোধ
GET https://www.googleapis.com/drive/v3/files/FILE_ID/permissionsপ্রতিক্রিয়া
{
"kind": "drive#permissionList",
"permissions": [
{
"id": "PERMISSION_ID",
"type": "user",
"kind": "drive#permission",
"role": "commenter"
}
]
}অনুমতি আপডেট করুন
কোনো ফাইল বা ফোল্ডারের অনুমতি আপডেট করতে, আপনি নির্ধারিত রোলটি পরিবর্তন করতে পারেন। রোলের উৎস খুঁজে বের করার বিষয়ে আরও তথ্যের জন্য, “রোলের উৎস নির্ধারণ করুন” দেখুন।
permissionsরিসোর্সেরupdateমেথডটি কল করুন, যেখানেfileIdপাথ প্যারামিটারটি সংশ্লিষ্ট ফাইল, ফোল্ডার বা শেয়ার্ড ড্রাইভে এবংpermissionIdপাথ প্যারামিটারটি পরিবর্তন করার পারমিশনে সেট করা থাকবে।permissionIdখুঁজে বের করার জন্য,permissionsরিসোর্সেরlistমেথডটিfileIdপাথ প্যারামিটারসহ ব্যবহার করুন।অনুরোধপত্রে নতুন
roleচিহ্নিত করুন।
ব্যবহারকারী বা গ্রুপটি আগে থেকেই সদস্য হলেও, আপনি একটি শেয়ার্ড ড্রাইভের স্বতন্ত্র ফাইল বা ফোল্ডারে অনুমতি প্রদান করতে পারেন। উদাহরণস্বরূপ, একটি শেয়ার্ড ড্রাইভে সদস্যপদের অংশ হিসেবে অ্যালেক্সের role=commenter রয়েছে। তবে, আপনার অ্যাপ অ্যালেক্সকে শেয়ার্ড ড্রাইভের একটি ফাইলের জন্য role=writer পারমিশনটি দিতে পারে। এক্ষেত্রে, যেহেতু নতুন রোলটি তার সদস্যপদের মাধ্যমে প্রাপ্ত রোলের চেয়ে বেশি অনুমতিমূলক, তাই নতুন পারমিশনটিই ফাইল বা ফোল্ডারটির জন্য কার্যকর রোল হয়ে যায়।
আপনি প্যাচ সেম্যান্টিকসের মাধ্যমে আপডেট প্রয়োগ করতে পারেন, অর্থাৎ আপনি একটি রিসোর্সে আংশিক পরিবর্তন করতে পারেন। আপনার অনুরোধে যে ফিল্ডগুলো আপনি পরিবর্তন করতে চান, সেগুলো আপনাকে অবশ্যই স্পষ্টভাবে উল্লেখ করতে হবে। অনুরোধে অন্তর্ভুক্ত নয় এমন ফিল্ডগুলো তাদের বিদ্যমান মান ধরে রাখে। আরও তথ্যের জন্য, ‘আংশিক রিসোর্স নিয়ে কাজ করা’ দেখুন।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি ফাইল বা ফোল্ডারের অনুমতি commenter থেকে writer এ পরিবর্তন করতে হয়। প্রতিক্রিয়াটি একটি permissions রিসোর্স'-এর ইনস্ট্যান্স ফেরত দেয়।
অনুরোধ
PATCH https://www.googleapis.com/drive/v3/files/FILE_ID/permissions/PERMISSION_ID
{
"role": "writer"
}প্রতিক্রিয়া
{
"kind": "drive#permission",
"id": "PERMISSION_ID",
"type": "user",
"role": "writer"
}ভূমিকার উৎস নির্ধারণ করুন
কোনো ফাইল বা ফোল্ডারের ভূমিকা পরিবর্তন করতে হলে, আপনাকে সেই ভূমিকার উৎস জানতে হবে। শেয়ার্ড ড্রাইভের ক্ষেত্রে, ভূমিকার উৎস হতে পারে শেয়ার্ড ড্রাইভের সদস্যপদ, কোনো ফোল্ডারের ভূমিকা, অথবা কোনো ফাইলের ভূমিকা।
একটি শেয়ার্ড ড্রাইভ বা তার ভেতরের আইটেমগুলোর জন্য রোল সোর্স নির্ধারণ করতে, fileId ও permissionId পাথ প্যারামিটার এবং fields প্যারামিটারটিকে permissionDetails ফিল্ডে সেট করে permissions রিসোর্সের ` get মেথডটি কল করুন।
permissionId খুঁজে পেতে, permissions রিসোর্সের list মেথডটি fileId পাথ প্যারামিটারসহ ব্যবহার করুন। list রিকোয়েস্টে permissionDetails ফিল্ডটি পেতে, fields প্যারামিটারটি permissions/permissionDetails এ সেট করুন।
এই ফিল্ডটি ব্যবহারকারী, গ্রুপ বা ডোমেইনের জন্য সমস্ত উত্তরাধিকারসূত্রে প্রাপ্ত এবং সরাসরি ফাইল পারমিশন তালিকাভুক্ত করে।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে রোলের উৎস নির্ধারণ করতে হয়। প্রতিক্রিয়াটি একটি permissions রিসোর্সের permissionDetails ফেরত দেয়। inheritedFrom ফিল্ডটি সেই আইটেমের আইডি প্রদান করে যেখান থেকে পারমিশনটি উত্তরাধিকারসূত্রে প্রাপ্ত হয়েছে।
অনুরোধ
GET https://www.googleapis.com/drive/v3/files/FILE_ID/permissions/PERMISSION_ID?fields=permissionDetails&supportsAllDrives=true
প্রতিক্রিয়া
{
"permissionDetails": [
{
"permissionType": "member",
"role": "commenter",
"inheritedFrom": "INHERITED_FROM_ID",
"inherited": true
},
{
"permissionType": "file",
"role": "writer",
"inherited": false
}
]
}ব্যাচ অনুরোধের মাধ্যমে একাধিক অনুমতি আপডেট করুন
একাধিক অনুমতি পরিবর্তন করার জন্য আমরা ব্যাচ রিকোয়েস্ট ব্যবহার করার জোরালো পরামর্শ দিই।
নিম্নলিখিতটি একটি ক্লায়েন্ট লাইব্রেরির অনুমতি একসাথে একাধিকবার পরিবর্তনের একটি উদাহরণ।
জাভা
পাইথন
নোড.জেএস
পিএইচপি
.NET
একটি অনুমতি মুছে ফেলুন
কোনো ফাইল বা ফোল্ডারের অ্যাক্সেস প্রত্যাহার করতে, permissions রিসোর্সের উপর delete মেথডটি কল করুন এবং পারমিশনটি মুছে ফেলার জন্য fileId ও permissionId পাথ প্যারামিটারগুলো সেট করুন।
উত্তরাধিকারসূত্রে প্রাপ্ত অনুমতি প্রত্যাহার করা যায় না। এর পরিবর্তে প্যারেন্ট ফোল্ডারের অনুমতি আপডেট বা ডিলিট করুন। কোনো ফোল্ডারের অনুমতি ডিলিট করলে তার চাইল্ড আইটেমগুলোর সমতুল্য অ্যাক্সেসও প্রত্যাহার হয়ে যায়।
অভিভাবকের তুলনায় অনুমতি কমাতে হলে সীমিত অ্যাক্সেস সেটিং ব্যবহার করতে হয়।
নিম্নলিখিত কোড নমুনাটি একটি permissionId মুছে ফেলার মাধ্যমে কীভাবে অ্যাক্সেস প্রত্যাহার করতে হয় তা দেখায়। সফল হলে, প্রতিক্রিয়া বডিটি একটি খালি JSON অবজেক্ট হয়। অনুমতিটি সরানো হয়েছে কিনা তা নিশ্চিত করতে, fileId পাথ প্যারামিটার সহ permissions রিসোর্সের ` list মেথডটি ব্যবহার করুন।
অনুরোধ
DELETE https://www.googleapis.com/drive/v3/files/FILE_ID/permissions/PERMISSION_ID
আইটেম অ্যাক্সেস সীমিত করতে একটি মেয়াদ শেষ হওয়ার তারিখ সেট করুন।
যখন আপনি কোনো সংবেদনশীল প্রকল্পে লোকজনের সাথে কাজ করছেন, তখন একটি নির্দিষ্ট সময় পর ড্রাইভের নির্দিষ্ট কিছু আইটেমে তাদের প্রবেশাধিকার সীমিত করতে চাইতে পারেন। ফাইল এবং ফোল্ডারের জন্য, আপনি একটি মেয়াদ শেষ হওয়ার তারিখ নির্ধারণ করে সেই আইটেমটিতে প্রবেশাধিকার সীমিত বা বন্ধ করে দিতে পারেন।
মেয়াদ শেষ হওয়ার তারিখ নির্ধারণ করতে:
permissionsরিসোর্সের উপরcreateমেথডটি ব্যবহার করুন এবংexpirationTimeফিল্ডটি (অন্যান্য প্রয়োজনীয় ফিল্ডগুলোর সাথে) সেট করুন। আরও তথ্যের জন্য, `Create a permission` দেখুন।permissionsরিসোর্সেupdateমেথডটি ব্যবহার করুন এবং অন্যান্য প্রয়োজনীয় ফিল্ডগুলোর সাথেexpirationTimeফিল্ডটিও সেট করুন। আরও তথ্যের জন্য, ‘আপডেট পারমিশন’ দেখুন।
expirationTime ফিল্ডটি RFC 3339 তারিখ-সময় ব্যবহার করে নির্দেশ করে যে অনুমতিটির মেয়াদ কখন শেষ হবে। মেয়াদ শেষ হওয়ার সময়ের নিম্নলিখিত সীমাবদ্ধতা রয়েছে:
- এগুলো শুধুমাত্র ব্যবহারকারী এবং গ্রুপের অনুমতিতে সেট করা যায়।
- সময় অবশ্যই ভবিষ্যতে হতে হবে।
- সময়টি ভবিষ্যতের এক বছরের বেশি হতে পারে না।
- শুধুমাত্র
readerরোলই কোনো ফোল্ডারের অ্যাক্সেসের মেয়াদ শেষ করার যোগ্য।
মেয়াদোত্তীর্ণের তারিখ সম্পর্কে আরও তথ্যের জন্য, নিম্নলিখিত নিবন্ধগুলি দেখুন:
- ফাইল অ্যাক্সেসের জন্য একটি মেয়াদ শেষ হওয়ার তারিখ নির্ধারণ করুন।
- একটি মেয়াদ শেষ হওয়ার তারিখ যোগ করুন
সম্পর্কিত বিষয়
- মুলতুবি থাকা প্রবেশাধিকার প্রস্তাবগুলি পরিচালনা করুন
- সীমিত এবং ব্যাপক অ্যাক্সেস সহ ফোল্ডারগুলি পরিচালনা করুন
- ফাইলের মালিকানা হস্তান্তর করুন
- ফাইলের বিষয়বস্তু সুরক্ষিত করুন
- রিসোর্স কী ব্যবহার করে লিঙ্ক-শেয়ার করা ড্রাইভের ফাইলগুলি অ্যাক্সেস করুন
- ভূমিকা এবং অনুমতি