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