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

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

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

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

ড্রাইভ API স্কোপ

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

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

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

ড্রাইভ API নিম্নলিখিত সুযোগগুলিকে সমর্থন করে:

স্কোপ কোড বর্ণনা ব্যবহার
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.appfolder
আপনার Google ড্রাইভে অ্যাপের নিজস্ব কনফিগারেশন ডেটা দেখুন এবং পরিচালনা করুন৷ প্রস্তাবিত
অ-সংবেদনশীল
https://www.googleapis.com/auth/drive.install অ্যাপগুলিকে "এর সাথে খুলুন" বা "নতুন" মেনুতে একটি বিকল্প হিসাবে উপস্থিত হওয়ার অনুমতি দিন৷ প্রস্তাবিত
অ-সংবেদনশীল
https://www.googleapis.com/auth/drive.file নতুন ড্রাইভ ফাইল তৈরি করুন, বা বিদ্যমান ফাইলগুলিকে সংশোধন করুন, যেগুলি আপনি একটি অ্যাপ দিয়ে খোলেন বা Google পিকার API বা অ্যাপের ফাইল পিকার ব্যবহার করার সময় ব্যবহারকারী একটি অ্যাপের সাথে শেয়ার করেন। প্রস্তাবিত
অ-সংবেদনশীল
https://www.googleapis.com/auth/drive.apps.readonly আপনার ড্রাইভ অ্যাক্সেস করার জন্য অনুমোদিত অ্যাপগুলি দেখুন৷ সংবেদনশীল
https://www.googleapis.com/auth/drive আপনার সমস্ত ড্রাইভ ফাইল দেখুন এবং পরিচালনা করুন৷ সীমাবদ্ধ
https://www.googleapis.com/auth/drive.readonly আপনার সমস্ত ড্রাইভ ফাইল দেখুন এবং ডাউনলোড করুন৷ সীমাবদ্ধ
https://www.googleapis.com/auth/drive.activity আপনার ড্রাইভে থাকা ফাইলগুলির কার্যকলাপ রেকর্ড দেখুন এবং যোগ করুন৷ সীমাবদ্ধ
https://www.googleapis.com/auth/drive.activity.readonly আপনার ড্রাইভে থাকা ফাইলগুলির কার্যকলাপের রেকর্ড দেখুন৷ সীমাবদ্ধ
https://www.googleapis.com/auth/drive.meet.readonly Google Meet দ্বারা তৈরি বা সম্পাদিত ড্রাইভ ফাইলগুলি দেখুন৷ সীমাবদ্ধ
https://www.googleapis.com/auth/drive.metadata আপনার ড্রাইভে ফাইলগুলির মেটাডেটা দেখুন এবং পরিচালনা করুন৷ সীমাবদ্ধ
https://www.googleapis.com/auth/drive.metadata.readonly আপনার ড্রাইভে থাকা ফাইলগুলির জন্য মেটাডেটা দেখুন৷ সীমাবদ্ধ
https://www.googleapis.com/auth/drive.scripts আপনার Google Apps স্ক্রিপ্ট স্ক্রিপ্টের আচরণ পরিবর্তন করুন৷ সীমাবদ্ধ

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

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

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

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

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

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

OAuth যাচাইকরণ

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

কখন একটি সীমাবদ্ধ সুযোগ ব্যবহার করতে হবে

ড্রাইভের জন্য, শুধুমাত্র নিম্নলিখিত অ্যাপ্লিকেশন প্রকারগুলি সীমাবদ্ধ সুযোগগুলি অ্যাক্সেস করতে পারে:

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

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

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

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

drive.file OAuth সুযোগের সুবিধা

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

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

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

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

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

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

রিফ্রেশ টোকেন সংরক্ষণ করুন

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