এই নির্দেশিকায় গুগল ড্রাইভ এপিআই ব্যবহার করে শেয়ার্ড ড্রাইভ পরিচালনা সম্পর্কিত কাজ, যেমন—শেয়ার্ড ড্রাইভ তৈরি করা এবং সদস্য ও অনুমতি ব্যবস্থাপনা করার বিষয়গুলো রয়েছে।
আপনি যদি রেসপন্সে ফেরত আসা ফিল্ডগুলো নির্দিষ্ট করতে চান, তাহলে drives রিসোর্সের যেকোনো মেথডের সাথে fields সিস্টেম প্যারামিটারটি সেট করতে পারেন। আপনি যদি fields প্যারামিটারটি নির্দিষ্ট না করেন, তাহলে সার্ভার মেথডটির জন্য নির্দিষ্ট কিছু ডিফল্ট ফিল্ড ফেরত দেয়। উদাহরণস্বরূপ, list মেথডটি প্রতিটি শেয়ার্ড ড্রাইভের জন্য শুধুমাত্র kind , id , এবং name ফিল্ডগুলো ফেরত দেয়। আরও তথ্যের জন্য, Return specific fields দেখুন।
শেয়ার্ড ড্রাইভ ফোল্ডারের সীমাবদ্ধতা সম্পর্কে আরও জানতে, শেয়ার্ড ড্রাইভ ফোল্ডারের সীমাবদ্ধতা দেখুন।
একটি শেয়ার্ড ড্রাইভ তৈরি করুন
একটি শেয়ার্ড ড্রাইভ তৈরি করতে, drives রিসোর্সের create মেথডটি requestId প্যারামিটারসহ ব্যবহার করুন।
` requestId প্যারামিটারটি একটি শেয়ার্ড ড্রাইভ আইডম্পোটেন্টভাবে তৈরির যৌক্তিক প্রচেষ্টাকে শনাক্ত করে। যদি অনুরোধটির সময়সীমা শেষ হয়ে যায় বা কোনো অনির্দিষ্ট ব্যাকএন্ড ত্রুটি দেখায়, তবে একই অনুরোধের পুনরাবৃত্তি করা যেতে পারে এবং এতে কোনো ডুপ্লিকেট তৈরি হবে না। অনুরোধের ` requestId এবং `body` অবশ্যই একই থাকতে হবে।
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একটি শেয়ার্ড ড্রাইভ তৈরি করতে হয়:
জাভা
পাইথন
নোড.জেএস
পিএইচপি
.NET
create মেথডের কলগুলো আইডম্পোটেন্ট।
যদি পূর্ববর্তী কোনো অনুরোধে বা পুনরায় চেষ্টার কারণে শেয়ার্ড ড্রাইভটি সফলভাবে তৈরি হয়ে থাকে, তাহলে মেথডটি drives রিসোর্সের একটি ইনস্ট্যান্স রিটার্ন করে। কখনও কখনও, যেমন দীর্ঘ সময় পরে বা অনুরোধের বডি পরিবর্তিত হলে, একটি 409 এরর রিটার্ন করা হতে পারে, যা নির্দেশ করে যে requestId বাতিল করতে হবে।
একটি শেয়ার্ড ড্রাইভ নিন
একটি শেয়ার করা ড্রাইভের মেটাডেটা পেতে, drives রিসোর্সের get মেথডের সাথে driveId পাথ প্যারামিটারটি ব্যবহার করুন। যদি আপনি ড্রাইভ আইডি না জানেন, তাহলে list মেথড ব্যবহার করে সমস্ত শেয়ার করা ড্রাইভের তালিকা দেখতে পারেন।
get মেথডটি একটি শেয়ার্ড ড্রাইভকে drives রিসোর্সের ইনস্ট্যান্স হিসেবে রিটার্ন করে।
ডোমেইন অ্যাডমিনিস্ট্রেটর হিসেবে অনুরোধটি জারি করতে, useDomainAdminAccess কোয়েরি প্যারামিটারটি true তে সেট করুন। আরও তথ্যের জন্য, ‘ডোমেইন অ্যাডমিনিস্ট্রেটর হিসেবে শেয়ার্ড ড্রাইভ পরিচালনা’ দেখুন।
শেয়ার করা ড্রাইভগুলির তালিকা
কোনো ব্যবহারকারীর শেয়ার করা ড্রাইভগুলোর তালিকা দেখতে, drives রিসোর্সের list মেথডটি ব্যবহার করুন। এই মেথডটি শেয়ার করা ড্রাইভগুলোর একটি তালিকা রিটার্ন করে।
শেয়ার করা ড্রাইভের পেজিনেশন কাস্টমাইজ করতে বা ফিল্টার করতে নিম্নলিখিত কোয়েরি প্যারামিটারগুলো পাস করুন:
pageSize: প্রতি পৃষ্ঠায় ফেরত দেওয়া শেয়ার্ড ড্রাইভের সর্বোচ্চ সংখ্যা।pageToken: পূর্ববর্তী তালিকা আহ্বান থেকে প্রাপ্ত একটি পৃষ্ঠা টোকেন। পরবর্তী পৃষ্ঠাটি পুনরুদ্ধার করতে এই টোকেনটি প্রদান করুন।q: শেয়ার করা ড্রাইভ অনুসন্ধানের জন্য কোয়েরি স্ট্রিং। আরও তথ্যের জন্য, শেয়ার করা ড্রাইভ অনুসন্ধান দেখুন।useDomainAdminAccess: অনুরোধকারী যে ডোমেইনের প্রশাসক, সেই ডোমেইনের সমস্ত শেয়ার্ড ড্রাইভ ফেরত পেতে, ডোমেইন প্রশাসক হিসাবে অনুরোধটি পাঠানোর জন্য এটিকে 'trueসেট করুন। আরও তথ্যের জন্য, 'ডোমেইন প্রশাসক হিসাবে শেয়ার্ড ড্রাইভ পরিচালনা' দেখুন।
একটি শেয়ার করা ড্রাইভ আপডেট করুন
একটি শেয়ার্ড ড্রাইভের মেটাডেটা আপডেট করতে, drives রিসোর্সের update মেথডটি driveId পাথ প্যারামিটারসহ ব্যবহার করুন।
এই মেথডটি একটি শেয়ার্ড ড্রাইভকে ' drives রিসোর্সের ইনস্ট্যান্স হিসেবে রিটার্ন করে।
ডোমেইন অ্যাডমিনিস্ট্রেটর হিসেবে অনুরোধটি জারি করতে, useDomainAdminAccess কোয়েরি প্যারামিটারটি true তে সেট করুন। আরও তথ্যের জন্য, ‘ডোমেইন অ্যাডমিনিস্ট্রেটর হিসেবে শেয়ার্ড ড্রাইভ পরিচালনা’ দেখুন।
একটি শেয়ার করা ড্রাইভ লুকান এবং প্রকাশ করুন
ডিফল্ট ভিউ থেকে কোনো শেয়ার করা ড্রাইভ লুকানোর জন্য, drives রিসোর্সের hide মেথডটিতে driveId প্যারামিটারটি ব্যবহার করুন।
যখন কোনো শেয়ার্ড ড্রাইভ লুকানো হয়, তখন Drive সেই শেয়ার্ড ড্রাইভ রিসোর্সটিকে hidden=true হিসেবে চিহ্নিত করে। লুকানো শেয়ার্ড ড্রাইভগুলো Drive UI-তে বা ফেরত আসা ফাইলের তালিকায় দেখা যায় না।
একটি শেয়ার করা ড্রাইভকে ডিফল্ট ভিউতে পুনরুদ্ধার করতে, drives রিসোর্সের unhide মেথডটি driveId প্যারামিটারসহ ব্যবহার করুন।
উভয় পদ্ধতিই একটি শেয়ার্ড ড্রাইভকে ' drives রিসোর্সের ইনস্ট্যান্স হিসেবে ফেরত দেয়।
একটি শেয়ার করা ড্রাইভ মুছে ফেলুন
একটি শেয়ার্ড ড্রাইভ স্থায়ীভাবে মুছে ফেলার জন্য, drives রিসোর্সের delete মেথডটিতে driveId প্যারামিটারটি ব্যবহার করুন।
একটি শেয়ার্ড ড্রাইভ ডিলিট করার আগে, সেই ড্রাইভের সমস্ত কন্টেন্ট অবশ্যই ট্র্যাশে সরাতে হবে অথবা ডিলিট করতে হবে। এছাড়াও, শেয়ার্ড ড্রাইভ ফোল্ডারটিতে ব্যবহারকারীর role=organizer থাকতে হবে। আরও তথ্যের জন্য, ফাইল ও ফোল্ডার ট্র্যাশ বা ডিলিট করা দেখুন।
শেয়ার করা ড্রাইভগুলো ফিল্টার করতে নিম্নলিখিত কোয়েরি প্যারামিটারগুলো পাস করুন:
useDomainAdminAccess: অনুরোধকারী যে ডোমেইনের প্রশাসক, সেই ডোমেইনের সমস্ত শেয়ার্ড ড্রাইভ ফেরত পেতে, ডোমেইন প্রশাসক হিসাবে অনুরোধটি পাঠানোর জন্য এটিকে 'trueসেট করুন। আরও তথ্যের জন্য, 'ডোমেইন প্রশাসক হিসাবে শেয়ার্ড ড্রাইভ পরিচালনা' দেখুন।allowItemDeletion: শেয়ার করা ড্রাইভের ভেতরের আইটেমগুলো ডিলিট করতে এটিকেtrueতে সেট করুন। এটি শুধুমাত্র তখনই সমর্থিত হবে যখনuseDomainAdminAccessওtrueতে সেট করা থাকবে।
শেয়ার করা ড্রাইভের সদস্যদের যোগ বা অপসারণ করুন
permissions রিসোর্স ব্যবহার করে শেয়ার্ড ড্রাইভের সদস্য যোগ বা অপসারণ করুন।
সদস্য যোগ করতে, শেয়ার করা ড্রাইভে অনুমতি তৈরি করুন। সদস্যদের অতিরিক্ত সুবিধা দিতে বা অ-সদস্যদের নির্দিষ্ট আইটেমে সহযোগিতা করার অনুমতি দিতে, শেয়ার করা ড্রাইভের মধ্যে থাকা স্বতন্ত্র ফাইলগুলিতেও অনুমতি পদ্ধতি ব্যবহার করা যেতে পারে।
আরও তথ্য এবং নমুনা কোডের জন্য, ফাইল, ফোল্ডার এবং ড্রাইভ শেয়ার দেখুন।
ডোমেইন অ্যাডমিনিস্ট্রেটর হিসেবে শেয়ার্ড ড্রাইভগুলো পরিচালনা করুন
একটি সংস্থা জুড়ে শেয়ার করা ড্রাইভগুলি পরিচালনা করতে, drives এবং permissions রিসোর্সগুলির সাথে useDomainAdminAccess প্যারামিটারটি প্রয়োগ করুন।
যেসব ব্যবহারকারী useDomainAdminAccess=true সহ এই মেথডগুলো কল করেন, তাদের অবশ্যই Drive and Docs অ্যাডমিনিস্ট্রেটর প্রিভিলেজ থাকতে হবে। অ্যাডমিনিস্ট্রেটররা কোনো নির্দিষ্ট শেয়ার্ড ড্রাইভে সদস্য হোন বা না হোন, তারা তাদের প্রতিষ্ঠানের মালিকানাধীন শেয়ার্ড ড্রাইভ অনুসন্ধান করতে বা সেগুলোর পারমিশন আপডেট করতে পারেন।
সার্ভিস অ্যাকাউন্ট ব্যবহার করার সময়, আপনাকে সার্ভিস অ্যাকাউন্ট ইমপার্সোনেশন ব্যবহার করে একজন অথেনটিকেটেড অ্যাডমিনিস্ট্রেটরের ছদ্মবেশ ধারণ করতে হতে পারে। মনে রাখবেন যে, ইউজার অ্যাকাউন্টের মতো সার্ভিস অ্যাকাউন্টগুলো আপনার গুগল ওয়ার্কস্পেস ডোমেইনের অন্তর্ভুক্ত নয় । আপনি যদি আপনার সম্পূর্ণ গুগল ওয়ার্কস্পেস ডোমেইনের সাথে ডকুমেন্ট বা ইভেন্টের মতো গুগল ওয়ার্কস্পেস অ্যাসেট শেয়ার করেন, তবে সেগুলো সার্ভিস অ্যাকাউন্টের সাথে শেয়ার করা হয় না। আরও তথ্যের জন্য, সার্ভিস অ্যাকাউন্ট ওভারভিউ দেখুন।
এমন একটি শেয়ার্ড ড্রাইভ পুনরুদ্ধার করুন যেটিতে কোনো অর্গানাইজার নেই
নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে এমন শেয়ার্ড ড্রাইভ পুনরুদ্ধার করতে হয় যেগুলিতে আর কোনো অর্গানাইজার নেই।
জাভা
পাইথন
নোড.জেএস
পিএইচপি
.NET
ব্যবহারকারীদের আপনার ফাইল ডাউনলোড, প্রিন্ট বা কপি করা থেকে বিরত রাখুন।
আপনি শেয়ার করা ড্রাইভের মধ্যে ব্যবহারকারীরা কীভাবে ফাইল ডাউনলোড, প্রিন্ট এবং কপি করতে পারবে তা সীমিত করতে পারেন।
ব্যবহারকারী কোনো শেয়ার্ড ড্রাইভের আয়োজক-আরোপিত ডাউনলোড সীমাবদ্ধতা পরিবর্তন করতে পারবেন কিনা তা নির্ধারণ করতে, capabilities.canChangeDownloadRestriction বুলিয়ান ফিল্ডটি দেখুন। যদি capabilities.canChangeDownloadRestriction এর মান true সেট করা থাকে, তাহলে শেয়ার্ড ড্রাইভটিতে ডাউনলোড সীমাবদ্ধতা প্রয়োগ করা যাবে। আরও তথ্যের জন্য, "Understand file capabilities" দেখুন।
drives রিসোর্সটিতে বেশ কিছু বুলিয়ান restrictions ফিল্ড রয়েছে, যা একটি শেয়ার্ড ড্রাইভে কোনো অ্যাকশন সম্পাদন করা যাবে কিনা তা নির্দেশ করতে ব্যবহৃত হয়। এই রেস্ট্রিকশনগুলো একটি শেয়ার্ড ড্রাইভ অথবা এর ভেতরের আইটেমগুলোর উপর প্রযোজ্য হয়। drives.update মেথড ব্যবহার করে রেস্ট্রিকশনগুলো সেট করা যায়।
একটি শেয়ার্ড ড্রাইভে ডাউনলোড সীমাবদ্ধতা প্রয়োগ করতে, একজন শেয়ার্ড ড্রাইভ ম্যানেজার DownloadRestriction অবজেক্ট ব্যবহার করে drives রিসোর্সের restrictions.downloadRestriction ফিল্ডটি সেট করতে পারেন। restrictedForReaders বুলিয়ান ফিল্ডটিকে true সেট করার অর্থ হলো রিডারদের জন্য ডাউনলোড এবং কপি উভয়ই সীমাবদ্ধ। restrictedForWriters বুলিয়ান ফিল্ডটিকে true সেট করার অর্থ হলো রাইটারদের জন্য ডাউনলোড এবং কপি উভয়ই সীমাবদ্ধ। উল্লেখ্য যে, যদি restrictedForWriters ফিল্ডটি true হয়, তাহলে রিডারদের জন্যও ডাউনলোড এবং কপি সীমাবদ্ধ থাকবে। একইভাবে, restrictedForWriters কে true এবং restrictedForReaders false সেট করা, restrictedForWriters এবং restrictedForReaders উভয়কেই true সেট করার সমতুল্য।
পশ্চাৎ সামঞ্জস্যতা
DownloadRestriction অবজেক্টটি চালু হওয়ার ফলে, restrictions.copyRequiresWriterPermission বুলিয়ান ফিল্ডটির কার্যকারিতা হালনাগাদ করা হয়েছে।
এখন, restrictions.copyRequiresWriterPermission true সেট করলে DownloadRestriction অবজেক্টের restrictedForReaders বুলিয়ান ফিল্ডটি true তে আপডেট হয়ে যায়, যা ঘোষণা করে যে পাঠকদের জন্য ডাউনলোড এবং কপি উভয়ই সীমাবদ্ধ।
copyRequiresWriterPermission ফিল্ডটির মান ` false সেট করলে ` restrictedForWriters এবং restrictedForReaders উভয় ফিল্ডই ` false হয়ে যায়। এর অর্থ হলো, সকল ব্যবহারকারীর জন্য ডাউনলোড বা কপি করার সীমাবদ্ধতার সেটিংস মুছে ফেলা হয়।
যে ক্ষেত্রগুলি ডাউনলোড, প্রিন্ট এবং কপি বৈশিষ্ট্যগুলি নিয়ন্ত্রণ করে
নিম্নলিখিত সারণিতে drives সেই রিসোর্স ফিল্ডগুলির তালিকা দেওয়া হলো যেগুলি ডাউনলোড, প্রিন্ট এবং কপি কার্যকারিতাকে প্রভাবিত করে:
| মাঠ | বর্ণনা | সংস্করণ |
|---|---|---|
capabilities.canCopy | বর্তমান ব্যবহারকারী শেয়ার করা ড্রাইভে ফাইল কপি করতে পারবেন কিনা। | v2 এবং v3 |
capabilities.canDownload | বর্তমান ব্যবহারকারী শেয়ার করা ড্রাইভ থেকে ফাইল ডাউনলোড করতে পারবেন কিনা। | v2 এবং v3 |
capabilities.canChangeCopyRequiresWriterPermission | বর্তমান ব্যবহারকারী কোনো শেয়ার্ড ড্রাইভের copyRequiresWriterPermission সীমাবদ্ধতা পরিবর্তন করতে পারবেন কিনা। | v2 এবং v3 |
capabilities.canResetDriveRestrictions | বর্তমান ব্যবহারকারী শেয়ার করা ড্রাইভের বিধিনিষেধগুলো ডিফল্ট অবস্থায় রিসেট করতে পারবেন কিনা। | v2 এবং v3 |
capabilities.canChangeDownloadRestriction | বর্তমান ব্যবহারকারী কোনো শেয়ার্ড ড্রাইভের ডাউনলোড সীমাবদ্ধতা পরিবর্তন করতে পারবেন কিনা। | শুধুমাত্র v3 |
restrictions.copyRequiresWriterPermission | শেয়ার করা ড্রাইভের ভেতরের ফাইল কপি, প্রিন্ট বা ডাউনলোড করার অপশনগুলো পাঠক এবং মন্তব্যকারীদের জন্য নিষ্ক্রিয় থাকবে কিনা। যখন এটি true , তখন এই শেয়ার করা ড্রাইভের ভেতরের যেকোনো ফাইলের জন্য একই নামের ফিল্ডটির মান ' true সেট হয়ে যায়। | v2 এবং v3 |
restrictions.downloadRestriction | শেয়ার্ড ড্রাইভ ম্যানেজার দ্বারা আরোপিত ডাউনলোড সীমাবদ্ধতা। | শুধুমাত্র v3 |
ফোল্ডারের সীমা
শেয়ার্ড ড্রাইভ ফোল্ডারগুলোর ধারণক্ষমতার সীমাবদ্ধতা রয়েছে। এ বিষয়ে বিস্তারিত জানতে, গুগল ড্রাইভে শেয়ার্ড ড্রাইভের সীমাবদ্ধতা দেখুন।
আইটেম ক্যাপ
প্রতিটি ব্যবহারকারীর শেয়ার করা ড্রাইভে ফাইল, ফোল্ডার এবং শর্টকাট সহ মোট ৫,০০,০০০টি আইটেমের সীমা রয়েছে।
সীমা পূর্ণ হয়ে গেলে, শেয়ার করা ড্রাইভটি আর কোনো আইটেম গ্রহণ করতে পারে না। পুনরায় ফাইল গ্রহণ শুরু করতে, ব্যবহারকারীদের অবশ্যই শেয়ার করা ড্রাইভ থেকে আইটেমগুলো স্থায়ীভাবে মুছে ফেলতে হবে। মনে রাখবেন যে, ট্র্যাশে থাকা আইটেমগুলো সীমার মধ্যে গণনা করা হয়, কিন্তু স্থায়ীভাবে মুছে ফেলা আইটেমগুলো গণনা করা হয় না। আরও তথ্যের জন্য, ‘ফাইল এবং ফোল্ডার ট্র্যাশ বা ডিলিট করুন’ দেখুন।
ফোল্ডারের গভীরতার সীমা
একটি শেয়ার্ড ড্রাইভের কোনো ফোল্ডারে ১০০টির বেশি স্তরের নেস্টেড ফোল্ডার থাকতে পারে না। এর মানে হলো, একটি চাইল্ড ফোল্ডার ৯৯ স্তরের বেশি গভীর কোনো ফোল্ডারের অধীনে রাখা যাবে না। এই সীমাবদ্ধতাটি শুধুমাত্র চাইল্ড ফোল্ডারগুলোর ক্ষেত্রেই প্রযোজ্য।
১০০টির বেশি স্তরের ফোল্ডার যোগ করার চেষ্টা করলে ` teamDriveHierarchyTooDeep HTTP স্ট্যাটাস কোড প্রতিক্রিয়া পাওয়া যায়।