Google Drive API স্কোপগুলি বেছে নিন

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

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

আপনার অ্যাপ অনুমোদন করার জন্য, Google Drive API-এর জন্য আপনাকে দুটি জায়গায় OAuth স্কোপ সংজ্ঞায়িত করতে হবে: Google Cloud console এবং আপনার অ্যাপ।

গুগল ক্লাউড কনসোলে, আপনার অ্যাপের OAuth কনসেন্ট স্ক্রিন কনফিগারেশনে আপনাকে অবশ্যই কোন স্কোপগুলির প্রয়োজন তা ঘোষণা করতে হবে। এটি আপনার অ্যাপের অনুরোধ করা সর্বোচ্চ স্তরের অনুমতি। এটি গুগলের কাছে একটি আনুষ্ঠানিক অনুরোধ হিসাবে কাজ করে এবং ঘোষিত স্কোপগুলি হল গুগল ব্যবহারকারীদের কাছে সম্মতি স্ক্রিনে যা প্রদর্শন করে। এটি ব্যবহারকারীকে ঠিক বুঝতে সাহায্য করে যে আপনার অ্যাপ কোন ডেটা এবং ক্রিয়াকলাপগুলিতে অ্যাক্সেসের অনুরোধ করছে।

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

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

আপনার অ্যাপের কোডের মধ্যে একবারে এক বা একাধিক OAuth স্কোপকে অ্যারে হিসেবে ঘোষণা করতে পারেন।

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে একাধিক OAuth স্কোপ ঘোষণা করতে হয়:

List<String> SCOPES = Arrays.asList(
  DriveScopes.DRIVE_FILE,
  DriveScopes.DRIVE_METADATA_READONLY
);

SCOPES = [
  "https://www.googleapis.com/auth/drive.file",
  "https://www.googleapis.com/auth/drive.metadata.readonly",
]

const SCOPES = [
  'https://www.googleapis.com/auth/drive.file',
  'https://www.googleapis.com/auth/drive.metadata.readonly'
];

পূর্ণ কোড নমুনায় স্কোপগুলি কীভাবে ঘোষণা করা হয় এবং ব্যবহার করা হয় তা দেখতে, Quickstarts দেখুন।

ড্রাইভ এপিআই স্কোপ

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

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

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

অ-সংবেদনশীল স্কোপ

বেশিরভাগ ব্যবহারের ক্ষেত্রে নিম্নলিখিত ড্রাইভ এপিআই স্কোপগুলি সুপারিশ করা হয়:

সংবেদনশীল স্কোপ

সীমাবদ্ধ সুযোগ

পূর্ববর্তী সারণির স্কোপগুলি নিম্নলিখিত সংজ্ঞা অনুসারে তাদের সংবেদনশীলতা নির্দেশ করে:

• সংবেদনশীল নয় : এই স্কোপগুলি অনুমোদনের ক্ষুদ্রতম সুযোগ প্রদান করে এবং শুধুমাত্র মৌলিক OAuth অ্যাপ যাচাইকরণের প্রয়োজন হয়। আরও তথ্যের জন্য, যাচাইকরণের প্রয়োজনীয়তাগুলি দেখুন।

• সংবেদনশীল : এই স্কোপগুলি আপনার অ্যাপের জন্য ব্যবহারকারীদের দ্বারা অনুমোদিত নির্দিষ্ট Google ব্যবহারকারীর ডেটাতে অ্যাক্সেস প্রদান করে। তাদের অতিরিক্ত OAuth অ্যাপ যাচাইকরণ প্রয়োজন। আরও তথ্যের জন্য, সংবেদনশীল এবং সীমাবদ্ধ স্কোপের প্রয়োজনীয়তা দেখুন।

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

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

যদি আপনার অ্যাপের অন্য কোনও Google API-তে অ্যাক্সেসের প্রয়োজন হয়, তাহলে আপনি সেই স্কোপগুলিও যোগ করতে পারেন। Google API স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google API-তে অ্যাক্সেস করার জন্য OAuth 2.0 ব্যবহার করা দেখুন।

নির্দিষ্ট OAuth 2.0 স্কোপ সম্পর্কে আরও তথ্যের জন্য, Google API-এর জন্য OAuth 2.0 স্কোপ দেখুন।

সীমাবদ্ধ সুযোগের জন্য যোগ্যতা

শুধুমাত্র নির্দিষ্ট ধরণের অ্যাপ্লিকেশনই Google ড্রাইভের জন্য সীমাবদ্ধ স্কোপ ব্যবহার করতে পারবে। যোগ্যতা অর্জনের জন্য, আপনার অ্যাপটিকে নিম্নলিখিত বিভাগগুলির মধ্যে একটিতে পড়তে হবে:

1. ব্যাকআপ এবং সিঙ্ক : প্ল্যাটফর্ম-নির্দিষ্ট এবং ওয়েব অ্যাপ যা ব্যবহারকারীদের ড্রাইভ ফাইলের স্থানীয় সিঙ্ক বা স্বয়ংক্রিয় ব্যাকআপ প্রদান করে।

2. উৎপাদনশীলতা এবং শিক্ষা : প্রাথমিক ব্যবহারকারী ইন্টারফেস সহ অ্যাপগুলির মধ্যে ড্রাইভ ফাইল, মেটাডেটা বা অনুমতিগুলির সাথে ইন্টারঅ্যাকশন জড়িত থাকতে পারে। এই অ্যাপগুলির মধ্যে রয়েছে টাস্ক ম্যানেজমেন্ট, নোট-টেকিং, ওয়ার্কগ্রুপ যোগাযোগ এবং ক্লাসরুম সহযোগিতা অ্যাপ।

3. রিপোর্টিং এবং নিরাপত্তা : এমন অ্যাপ যা ব্যবহারকারী বা গ্রাহককে ফাইলগুলি কীভাবে ভাগ করা বা অ্যাক্সেস করা হয় সে সম্পর্কে অন্তর্দৃষ্টি প্রদান করে।

সীমাবদ্ধ স্কোপ ব্যবহার চালিয়ে যেতে, আপনার অ্যাপটিকে সীমাবদ্ধ স্কোপ যাচাইকরণের জন্য প্রস্তুত করা উচিত।

সীমাবদ্ধ স্কোপ থেকে একটি বিদ্যমান অ্যাপ স্থানান্তর করুন

যদি আপনার ড্রাইভ অ্যাপটি সীমাবদ্ধ স্কোপ ব্যবহার করে, তাহলে আমরা আপনাকে একটি অ-সংবেদনশীল ড্রাইভ API স্কোপে স্থানান্তর করার পরামর্শ দিচ্ছি। drive.file এর মতো অ-সংবেদনশীল স্কোপ ব্যবহার করে, প্রতি ফাইলের জন্য অনুমতি দেওয়া হয় এবং একটি অ্যাপের জন্য প্রয়োজনীয় নির্দিষ্ট বৈশিষ্ট্যগুলিতে অ্যাক্সেস সীমিত করা হয়।

অনেক অ্যাপ কোনও পরিবর্তন ছাড়াই প্রতি-ফাইল অ্যাক্সেসে রূপান্তরিত হতে পারে।

আপনি যদি নিজের ফাইল পিকার ব্যবহার করেন, তাহলে আমরা আপনাকে Google Picker API ব্যবহার করার পরামর্শ দিচ্ছি যা সম্পূর্ণরূপে বিভিন্ন স্কোপ সমর্থন করে।

ড্রাইভ ফাইল স্কোপের সুবিধা

Google Picker API-এর সাথে drive.file OAuth স্কোপ ব্যবহার করলে আপনার অ্যাপের ব্যবহারকারীর অভিজ্ঞতা এবং নিরাপত্তা উভয়ই অপ্টিমাইজ হয়।

drive.file OAuth স্কোপ ব্যবহারকারীদের আপনার অ্যাপের সাথে কোন ফাইলগুলি শেয়ার করতে চান তা বেছে নিতে দেয়। এটি তাদের আরও নিয়ন্ত্রণ এবং আত্মবিশ্বাস দেয় যে তাদের ফাইলগুলিতে আপনার অ্যাপের অ্যাক্সেস সীমিত এবং আরও নিরাপদ। বিপরীতে, সমস্ত ড্রাইভ ফাইলে বিস্তৃত অ্যাক্সেসের প্রয়োজন ব্যবহারকারীদের আপনার অ্যাপের সাথে ইন্টারঅ্যাক্ট করতে নিরুৎসাহিত করতে পারে।

drive.file স্কোপ ব্যবহার করার কিছু কারণ নিচে দেওয়া হল:

• ব্যবহারযোগ্যতা : drive.file স্কোপটি সমস্ত Drive API REST রিসোর্সের সাথে কাজ করে যার অর্থ আপনি এটিকে বৃহত্তর OAuth স্কোপগুলির মতোই ব্যবহার করতে পারবেন।

• বৈশিষ্ট্য : গুগল পিকার এপিআই ড্রাইভ ইউআই-এর অনুরূপ ইন্টারফেস প্রদান করে। এতে ড্রাইভ ফাইলের প্রিভিউ এবং থাম্বনেইল দেখানো বেশ কয়েকটি ভিউ এবং একটি ইনলাইন, মোডাল উইন্ডো রয়েছে যাতে ব্যবহারকারীরা কখনই মূল অ্যাপটি ছেড়ে না যান।

• সুবিধা : গুগল পিকার ফাইলগুলিতে ফিল্টার ব্যবহার করার সময় অ্যাপগুলি নির্দিষ্ট ড্রাইভ ফাইলের ধরণের (যেমন গুগল ডক্স, শিট এবং ফটো) জন্য ফিল্টার প্রয়োগ করতে পারে।

• সহজবোধ্য যাচাইকরণ : যেহেতু drive.file সংবেদনশীল নয়, তাই এটি আরও সহজ যাচাইকরণ প্রক্রিয়ার সুযোগ করে দেয়।

রিফ্রেশ টোকেনগুলি নিরাপদে সংরক্ষণ করুন

ড্রাইভ এপিআই ব্যবহার করে ব্যক্তিগত ডেটা অ্যাক্সেস করতে, আপনার অ্যাপকে একটি অ্যাক্সেস টোকেন পেতে হবে যা সেই এপিআইতে অ্যাক্সেস মঞ্জুর করে। একটি একক অ্যাক্সেস টোকেন আপনার অনুরোধ করা স্কোপ দ্বারা নিয়ন্ত্রিত একাধিক এপিআইতে বিভিন্ন মাত্রার অ্যাক্সেস মঞ্জুর করতে পারে।

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

রিফ্রেশ টোকেনগুলি নিরাপদ, দীর্ঘমেয়াদী স্টোরেজে সংরক্ষণ করুন এবং যতক্ষণ পর্যন্ত বৈধ থাকবে ততক্ষণ ব্যবহার চালিয়ে যান।

আরও তথ্যের জন্য, Google API অ্যাক্সেস করতে OAuth 2.0 ব্যবহার করা দেখুন।

সম্পর্কিত বিষয়

• Google Workspace-এ প্রমাণীকরণ এবং অনুমোদনের একটি সারসংক্ষেপের জন্য, প্রমাণীকরণ এবং অনুমোদন সম্পর্কে জানুন দেখুন।
• গুগল ক্লাউডে প্রমাণীকরণ এবং অনুমোদনের একটি সারসংক্ষেপের জন্য, প্রমাণীকরণের সারসংক্ষেপ দেখুন।
• পরিষেবা অ্যাকাউন্ট সম্পর্কে আরও জানতে, পরিষেবা অ্যাকাউন্ট দেখুন।
• সমস্যা সমাধানে সাহায্যের জন্য, ত্রুটি সমাধান দেখুন।