Google Photos Library API-এ মিডিয়া আইটেম এবং অ্যালবাম অ্যাক্সেস করতে ব্যবহৃত একাধিক স্কোপ রয়েছে। বিভিন্ন কল থেকে প্রত্যাবর্তিত প্রতিক্রিয়াগুলি ভিন্ন হয় যার ভিত্তিতে বিকাশকারীর দ্বারা অনুরোধ করা হয়েছে।
Google Photos Library API-এ আপনার অ্যাপ্লিকেশন পাঠানো প্রতিটি অনুরোধে অবশ্যই একটি অনুমোদন টোকেন অন্তর্ভুক্ত করতে হবে। টোকেনটি Google-এ আপনার আবেদনকেও শনাক্ত করে।
অনুমোদন প্রোটোকল সম্পর্কে
অনুরোধ অনুমোদন করতে আপনার অ্যাপ্লিকেশন অবশ্যই OAuth 2.0 ব্যবহার করবে। অন্য কোন অনুমোদন প্রোটোকল সমর্থিত হয় না. যদি আপনার অ্যাপ্লিকেশন Google এর সাথে সাইন ইন ব্যবহার করে, তবে অনুমোদনের কিছু দিক আপনার জন্য পরিচালনা করা হয়।
OAuth 2.0 এর মাধ্যমে অনুরোধ অনুমোদন করা হচ্ছে
Google Photos Library API-এর সমস্ত অনুরোধ একজন প্রমাণীকৃত ব্যবহারকারীর দ্বারা অনুমোদিত হতে হবে।
OAuth 2.0-এর জন্য অনুমোদন প্রক্রিয়ার বিশদ বিবরণ বা "প্রবাহ" আপনি কোন ধরনের অ্যাপ্লিকেশন লিখছেন তার উপর নির্ভর করে কিছুটা পরিবর্তিত হয়। নিম্নলিখিত সাধারণ প্রক্রিয়া সব ধরনের আবেদনের ক্ষেত্রে প্রযোজ্য:
- আপনি যখন আপনার অ্যাপ্লিকেশন তৈরি করেন, আপনি Google API কনসোল ব্যবহার করে এটি নিবন্ধন করেন। Google তারপরে আপনার প্রয়োজন হবে এমন তথ্য প্রদান করে, যেমন একটি ক্লায়েন্ট আইডি এবং একটি ক্লায়েন্ট গোপন।
- Google API কনসোলে Google Photos Library API সক্রিয় করুন। (যদি API কনসোলে এপিআই তালিকাভুক্ত না থাকে, তাহলে এই ধাপটি এড়িয়ে যান।)
- যখন আপনার অ্যাপ্লিকেশনটির ব্যবহারকারীর ডেটাতে অ্যাক্সেসের প্রয়োজন হয়, তখন এটি Google কে অ্যাক্সেসের একটি নির্দিষ্ট সুযোগের জন্য জিজ্ঞাসা করে।
- Google ব্যবহারকারীর কাছে একটি সম্মতি স্ক্রীন প্রদর্শন করে, তাদের কিছু ডেটা অনুরোধ করার জন্য আপনার আবেদনকে অনুমোদন করতে বলে।
- যদি ব্যবহারকারী অনুমোদন করেন, তাহলে Google আপনার অ্যাপ্লিকেশনকে একটি স্বল্পকালীন অ্যাক্সেস টোকেন দেয়।
- আপনার অ্যাপ্লিকেশন ব্যবহারকারীর ডেটা অনুরোধ করে, অনুরোধে অ্যাক্সেস টোকেন সংযুক্ত করে।
- যদি Google নির্ধারণ করে যে আপনার অনুরোধ এবং টোকেন বৈধ, এটি অনুরোধ করা ডেটা ফেরত দেয়।
কিছু প্রবাহে অতিরিক্ত পদক্ষেপ অন্তর্ভুক্ত থাকে, যেমন নতুন অ্যাক্সেস টোকেন অর্জন করতে রিফ্রেশ টোকেন ব্যবহার করে। বিভিন্ন ধরনের অ্যাপ্লিকেশনের জন্য প্রবাহ সম্পর্কে বিস্তারিত তথ্যের জন্য, Google এর OAuth 2.0 ডকুমেন্টেশন দেখুন।
Google Photos Library API-এর জন্য এখানে OAuth 2.0 স্কোপের তথ্য রয়েছে:
ব্যাপ্তি | অর্থ |
---|---|
https://www.googleapis.com/auth/photoslibrary.readonly | লাইব্রেরি এবং সমস্ত অ্যালবাম থেকে আইটেমগুলি তালিকাভুক্ত করুন, সমস্ত মিডিয়া আইটেম অ্যাক্সেস করুন এবং ব্যবহারকারীর মালিকানাধীন অ্যালবামগুলিকে তালিকাভুক্ত করুন, যা তাদের সাথে শেয়ার করা হয়েছে৷ ব্যবহারকারীর দ্বারা শেয়ার করা অ্যালবামের জন্য, শেয়ারের বৈশিষ্ট্যগুলি শুধুমাত্র ফেরত দেওয়া হয় যদি অ্যালবামের জন্য আরও তথ্যের জন্য, শেয়ার মিডিয়া দেখুন। |
https://www.googleapis.com/auth/photoslibrary.appendonly | প্রবেশাধিকার শুধুমাত্র লিখুন . বাইট আপলোড করতে, মিডিয়া আইটেম তৈরি করতে, অ্যালবাম তৈরি করতে এবং সমৃদ্ধি যোগ করতে অ্যাক্সেস করুন৷ শুধুমাত্র ব্যবহারকারীর লাইব্রেরিতে এবং অ্যাপ দ্বারা তৈরি অ্যালবামে নতুন মিডিয়া তৈরি করার অনুমতি দেয়৷ |
https://www.googleapis.com/auth/photoslibrary.readonly.appcreateddata | বিকাশকারী দ্বারা তৈরি মিডিয়া আইটেম এবং অ্যালবামগুলিতে অ্যাক্সেস পড়ুন৷ আরও তথ্যের জন্য, মিডিয়া আইটেম অ্যাক্সেস করুন এবং লাইব্রেরি বিষয়বস্তু, অ্যালবাম এবং মিডিয়া আইটেমগুলি তালিকাভুক্ত করুন দেখুন৷ |
https://www.googleapis.com/auth/photoslibrary.edit.appcreateddata | শুধুমাত্র অ্যাক্সেস সম্পাদনা করুন। বিকাশকারী দ্বারা তৈরি অ্যালবাম এবং মিডিয়া আইটেমগুলির জন্য এই বিবরণগুলি পরিবর্তন করতে অ্যাক্সেস: |
https://www.googleapis.com/auth/photoslibrary.sharing | একটি অ্যালবাম তৈরি করতে অ্যাক্সেস করুন, এটি ভাগ করুন, এতে মিডিয়া আইটেম আপলোড করুন এবং একটি ভাগ করা অ্যালবামে যোগ দিন৷ |
https://www.googleapis.com/auth/photoslibrary | সুপারিশ করা হয় না. শুধুমাত্র ক্রমবর্ধমান অনুমোদনের সাথে আপনার প্রয়োজনীয় স্কোপে অ্যাক্সেসের অনুরোধ করুন। |
OAuth 2.0 ব্যবহার করে অ্যাক্সেসের অনুরোধ করার জন্য, আপনার অ্যাপ্লিকেশনের সুযোগ তথ্যের প্রয়োজন, সেইসাথে আপনি যখন আপনার আবেদনটি নিবন্ধন করেন তখন Google সরবরাহ করে এমন তথ্য (যেমন ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট)।
টিপ: Google APIs ক্লায়েন্ট লাইব্রেরিগুলি আপনার জন্য কিছু অনুমোদন প্রক্রিয়া পরিচালনা করতে পারে৷ তারা বিভিন্ন প্রোগ্রামিং ভাষার জন্য উপলব্ধ; আরও বিস্তারিত জানার জন্য লাইব্রেরি এবং নমুনা সহ পৃষ্ঠাটি দেখুন।
সুযোগ নির্বাচন করা হচ্ছে
একটি সাধারণ নিয়ম হিসাবে, সম্ভাব্য সর্বাধিক সীমাবদ্ধ সুযোগ বেছে নিন এবং আপনার অ্যাপের প্রয়োজন নেই এমন সুযোগের অনুরোধ করা এড়িয়ে চলুন। ব্যবহারকারীরা আরও সহজে সীমিত, স্পষ্টভাবে বর্ণিত সুযোগগুলিতে অ্যাক্সেস মঞ্জুর করে৷ ব্যবহারকারীরা তাদের মিডিয়াতে বিস্তৃত অ্যাক্সেস মঞ্জুর করতে দ্বিধা করতে পারে যদি না তারা আপনার অ্যাপকে বিশ্বাস করে এবং কেন এটির তথ্য প্রয়োজন তা বুঝতে না পারে।
ক্রমবর্ধমানভাবে সুযোগের অনুরোধ করা হচ্ছে
অনুমোদনের জন্য সর্বোত্তম অভ্যাস অনুসরণ করে, আপনার আবেদনের শুধুমাত্র প্রয়োজন অনুযায়ী সুযোগের অনুরোধ করা উচিত। সাইন-ইন করার সময় আপনার আবেদনের জন্য সমস্ত সুযোগের অনুরোধ করা এড়িয়ে চলুন। পরিবর্তে, ন্যায্যতা প্রদান করুন এবং প্রসঙ্গে অনুরোধ করুন। স্পষ্টভাবে ব্যাখ্যা করুন যে আপনি আপনার ব্যবহারকারীদের ডেটা দিয়ে কী করবেন এবং ইউএক্স নির্দেশিকা এবং নোটিশ প্রদান এবং সম্মতি চাওয়ার সর্বোত্তম অনুশীলন অনুসারে অ্যাক্সেস মঞ্জুর করে তারা কীভাবে উপকৃত হবে।
পরিষেবা অ্যাকাউন্ট
লাইব্রেরি API পরিষেবা অ্যাকাউন্ট সমর্থন করে না। আপনার অ্যাপ্লিকেশানটিকে অবশ্যই অন্যান্য OAuth 2.0 ফ্লো ব্যবহার করতে হবে যেমন ওয়েব সার্ভার অ্যাপ্লিকেশনগুলির জন্য OAuth 2.0 বা মোবাইল এবং ডেস্কটপ অ্যাপ্লিকেশনগুলির জন্য OAuth 2.0৷