Google ডক্স API স্কোপ নির্বাচন করুন

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

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

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

ডক্স এপিআই স্কোপ

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

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

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

ডকস এপিআই নিম্নলিখিত স্কোপগুলো সমর্থন করে:

স্কোপ কোড বর্ণনা ব্যবহার
https://www.googleapis.com/auth/documents আপনার সমস্ত গুগল ডক্স ডকুমেন্ট দেখুন, সম্পাদনা করুন, তৈরি করুন এবং মুছে ফেলুন। সংবেদনশীল
https://www.googleapis.com/auth/documents.readonly আপনার সমস্ত গুগল ডক্স ডকুমেন্ট দেখুন। সংবেদনশীল
https://www.googleapis.com/auth/drive.file এই অ্যাপের মাধ্যমে আপনি শুধু আপনার নির্দিষ্ট গুগল ড্রাইভ ফাইলগুলোই দেখতে, সম্পাদনা করতে, তৈরি করতে এবং মুছে ফেলতে পারবেন। সুপারিশকৃত
অসংবেদনশীল
https://www.googleapis.com/auth/drive আপনার গুগল ড্রাইভের সমস্ত ফাইল দেখুন, সম্পাদনা করুন, তৈরি করুন এবং মুছে ফেলুন। সীমাবদ্ধ
https://www.googleapis.com/auth/drive.readonly আপনার গুগল ড্রাইভের সমস্ত ফাইল দেখুন এবং ডাউনলোড করুন। সীমাবদ্ধ

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

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

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

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

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

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