Google ড্রাইভ লেবেল API স্কোপগুলি বেছে নিন

এই ডকুমেন্টে ড্রাইভ লেবেল এপিআই-এর জন্য নির্দিষ্ট অনুমোদন এবং প্রমাণীকরণ সংক্রান্ত তথ্য রয়েছে। এই ডকুমেন্টটি পড়ার আগে, 'প্রমাণীকরণ এবং অনুমোদন সম্পর্কে জানুন' অংশে গুগল ওয়ার্কস্পেসের সাধারণ প্রমাণীকরণ এবং অনুমোদন সংক্রান্ত তথ্য অবশ্যই পড়ে নিন।

অনুমোদনের জন্য OAuth 2.0 কনফিগার করুন।

ব্যবহারকারী এবং অ্যাপ পর্যালোচকদের কাছে কোন তথ্য প্রদর্শিত হবে তা নির্ধারণ করতে OAuth সম্মতি স্ক্রিনটি কনফিগার করুন ও স্কোপ নির্বাচন করুন এবং আপনার অ্যাপটি নিবন্ধন করুন যাতে আপনি পরবর্তীতে এটি প্রকাশ করতে পারেন।

গুগল ড্রাইভ লেবেল এপিআই স্কোপ

আপনার অ্যাপকে প্রদত্ত অ্যাক্সেসের স্তর নির্ধারণ করতে, আপনাকে অথরাইজেশন স্কোপ শনাক্ত ও ঘোষণা করতে হবে। একটি অথরাইজেশন স্কোপ হলো একটি OAuth 2.0 URI স্ট্রিং, যাতে Google Workspace অ্যাপের নাম, এটি কোন ধরনের ডেটা অ্যাক্সেস করে এবং অ্যাক্সেসের স্তর উল্লেখ থাকে। স্কোপগুলো হলো Google Workspace ডেটার সাথে কাজ করার জন্য আপনার অ্যাপের অনুরোধ, যার মধ্যে ব্যবহারকারীদের Google অ্যাকাউন্টের ডেটাও অন্তর্ভুক্ত।

যখন আপনার অ্যাপটি ইনস্টল করা হয়, তখন ব্যবহারকারীকে অ্যাপটিতে ব্যবহৃত স্কোপগুলো যাচাই করতে বলা হয়। সাধারণত, আপনার যথাসম্ভব সবচেয়ে সুনির্দিষ্ট স্কোপটি বেছে নেওয়া উচিত এবং আপনার অ্যাপের প্রয়োজন নেই এমন স্কোপের জন্য অনুরোধ করা থেকে বিরত থাকা উচিত। ব্যবহারকারীরা সীমিত ও সুস্পষ্টভাবে বর্ণিত স্কোপগুলোতে আরও সহজে অ্যাক্সেস দিয়ে থাকেন।

সম্ভব হলে, আমরা অসংবেদনশীল স্কোপ ব্যবহার করার পরামর্শ দিই, কারণ এটি প্রতি-ফাইল অ্যাক্সেস স্কোপ প্রদান করে এবং একটি অ্যাপের প্রয়োজনীয় নির্দিষ্ট কার্যকারিতায় অ্যাক্সেসকে সীমাবদ্ধ করে।

ড্রাইভ আইটেমগুলিতে প্রয়োগ করা লেবেল মেটাডেটা পড়তে, অনুসন্ধান করতে এবং পরিবর্তন করতে নিম্নলিখিত OAuth 2.0 স্কোপগুলি ব্যবহার করা যেতে পারে:

পরিধি অর্থ
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata
 ড্রাইভ আইটেমগুলিতে প্রয়োগ করা লেবেল মেটাডেটা পড়ুন, অনুসন্ধান করুন এবং পরিবর্তন করুন।
  • https://www.googleapis.com/auth/drive.readonly
  • https://www.googleapis.com/auth/drive.metadata.readonly
 অ্যাপ্লিকেশনটির জন্য অনুমোদিত ড্রাইভ আইটেমগুলিতে প্রয়োগ করা লেবেল মেটাডেটা পড়ুন এবং অনুসন্ধান করুন।

আরও তথ্যের জন্য, Drive API OAuth 2.0 Scopes এবং Drive API-specific authorization দেখুন।

লেবেলের জন্য সুযোগ

লেবেল দেখতে ও পরিচালনা করতে নিম্নলিখিত OAuth স্কোপগুলি ব্যবহার করা যেতে পারে:

পরিধি অর্থ
https://www.googleapis.com/auth/drive.labels ড্রাইভ লেবেলগুলি দেখুন, ব্যবহার করুন এবং পরিচালনা করুন।
  • এই স্কোপটি ব্যবহারকারীকে অ্যাক্সেস দেয় এবং use_admin_access সেট করা না থাকলে রাইট অপারেশনের জন্য এটি প্রয়োজন।
  • এই স্কোপের রাইট অপারেশনগুলো SHARED লেবেল টাইপের লেবেলগুলোর জন্য বৈধ।
https://www.googleapis.com/auth/drive.labels.readonly ড্রাইভ লেবেলগুলো দেখুন ও ব্যবহার করুন।
  • এই স্কোপটি ব্যবহারকারীকে অ্যাক্সেস দেয় এবং use_admin_access সেট করা না থাকলে রিড অপারেশনের জন্য এটি প্রয়োজন।
https://www.googleapis.com/auth/drive.admin.labels আপনার প্রতিষ্ঠানের সমস্ত ড্রাইভ লেবেল দেখুন, সম্পাদনা করুন, তৈরি করুন এবং মুছে ফেলুন, এবং আপনার প্রতিষ্ঠানের লেবেল-সম্পর্কিত প্রশাসনিক নীতিসমূহ দেখুন।
  • এই স্কোপটি অ্যাডমিন অ্যাক্সেস প্রদান করে এবং use_admin_access সেট করা থাকলে রাইট অপারেশনের জন্য এটি আবশ্যক। এই স্কোপটি রিড অ্যাক্সেসও প্রদান করে।
  • এই স্কোপের রাইট অপারেশনগুলো SHARED বা ADMIN লেবেল টাইপের লেবেলগুলোর জন্য বৈধ।
https://www.googleapis.com/auth/drive.admin.labels.readonly আপনার প্রতিষ্ঠানের সমস্ত ড্রাইভ লেবেল এবং লেবেল-সম্পর্কিত প্রশাসনিক নীতিসমূহ দেখুন।
  • এই স্কোপটি অ্যাডমিন অ্যাক্সেস প্রদান করে এবং use_admin_access সেট করা থাকলে রিড অপারেশনের জন্য এটি আবশ্যক।

প্রশাসক অ্যাক্সেস

ADMIN লেবেল পরিচালনা করতে, আপনাকে অবশ্যই নির্দিষ্ট করতে হবে:

  • ব্যবহারকারীর অ্যাডমিনিস্ট্রেটর ক্রেডেনশিয়াল ব্যবহার করতে useAdminAccess মান true হবে।
  • লেবেল পরিচালনা করার বিশেষাধিকারপ্রাপ্ত অ্যাকাউন্ট প্রশাসকগণ।

useAdminAccess

প্রশাসকদের তাদের অ্যাডমিন সুবিধা প্রয়োগ করার জন্য অবশ্যই useAdminAccess প্যারামিটারটি সেট করতে হবে। useAdminAccess সেট করলে গ্রাহকের মালিকানাধীন যেকোনো লেবেল দেখা এবং সম্পাদনা করা যায়। এর মধ্যে ADMIN এবং SHARED উভয় লেবেলই অন্তর্ভুক্ত।

যখন useAdminAccess সেট করা থাকে না, তখন লেখার অনুরোধ শুধুমাত্র সেইসব লেবেলের জন্য অনুমোদিত হয় যেগুলোর label type SHARED এবং সেইসব ব্যবহারকারীর জন্য অনুমোদিত হয় যাদের এই লেবেলের জন্য উপযুক্ত EDITOR ভূমিকা রয়েছে।

আরও তথ্যের জন্য, অ্যাক্সেস ক্রেডেনশিয়াল তৈরি করুন দেখুন।