আপনার অ্যাপ্লিকেশন থেকে পোস্টমাস্টার টুলস এপিআই-তে পাঠানো প্রতিটি অনুরোধে অবশ্যই একটি অনুমোদন টোকেন অন্তর্ভুক্ত থাকতে হবে। এই টোকেনটি গুগলের কাছে আপনার অ্যাপ্লিকেশনকে শনাক্ত করতেও সাহায্য করে।
অনুমোদন প্রোটোকল সম্পর্কে
অনুরোধ অনুমোদনের জন্য আপনার অ্যাপ্লিকেশনকে অবশ্যই OAuth 2.0 ব্যবহার করতে হবে। অন্য কোনো অনুমোদন প্রোটোকল সমর্থিত নয়। যদি আপনার অ্যাপ্লিকেশন ‘Sign In With Google’ ব্যবহার করে, তবে অনুমোদনের কিছু দিক আপনার জন্য স্বয়ংক্রিয়ভাবে পরিচালিত হয়।
OAuth 2.0 দিয়ে অনুরোধ অনুমোদন করা হচ্ছে
পোস্টমাস্টার টুলস এপিআই-তে করা সকল অনুরোধ অবশ্যই একজন প্রমাণীকৃত ব্যবহারকারী দ্বারা অনুমোদিত হতে হবে।
আপনি কী ধরনের অ্যাপ্লিকেশন তৈরি করছেন তার উপর নির্ভর করে OAuth 2.0-এর অনুমোদন প্রক্রিয়া বা 'ফ্লো'-এর বিবরণ কিছুটা ভিন্ন হয়। নিম্নলিখিত সাধারণ প্রক্রিয়াটি সকল প্রকার অ্যাপ্লিকেশনের জন্য প্রযোজ্য:
- যখন আপনি আপনার অ্যাপ্লিকেশন তৈরি করেন, তখন আপনি গুগল এপিআই কনসোল ব্যবহার করে এটি নিবন্ধন করেন। এরপর গুগল আপনাকে এমন কিছু তথ্য সরবরাহ করে যা আপনার পরবর্তীতে প্রয়োজন হবে, যেমন একটি ক্লায়েন্ট আইডি এবং একটি ক্লায়েন্ট সিক্রেট।
- Google API Console-এ Postmaster Tools API-টি সক্রিয় করুন। (যদি API-টি API Console-এ তালিকাভুক্ত না থাকে, তাহলে এই ধাপটি এড়িয়ে যান।)
- যখন আপনার অ্যাপ্লিকেশনের ব্যবহারকারীর ডেটাতে অ্যাক্সেসের প্রয়োজন হয়, তখন এটি গুগলের কাছে একটি নির্দিষ্ট পরিসরের অ্যাক্সেসের জন্য অনুরোধ করে।
- গুগল ব্যবহারকারীর সামনে একটি সম্মতি স্ক্রিন প্রদর্শন করে, যেখানে আপনার অ্যাপ্লিকেশনকে তাদের কিছু ডেটা অনুরোধ করার অনুমোদন দিতে বলা হয়।
- ব্যবহারকারী অনুমোদন করলে, গুগল আপনার অ্যাপ্লিকেশনটিকে একটি স্বল্পস্থায়ী অ্যাক্সেস টোকেন দেয়।
- আপনার অ্যাপ্লিকেশনটি অনুরোধের সাথে অ্যাক্সেস টোকেন সংযুক্ত করে ব্যবহারকারীর ডেটার জন্য অনুরোধ করে।
- যদি গুগল আপনার অনুরোধ এবং টোকেনটিকে বৈধ বলে মনে করে, তবে এটি অনুরোধ করা ডেটা ফেরত দেয়।
কিছু ফ্লো-তে অতিরিক্ত ধাপ অন্তর্ভুক্ত থাকে, যেমন নতুন অ্যাক্সেস টোকেন পাওয়ার জন্য রিফ্রেশ টোকেন ব্যবহার করা। বিভিন্ন ধরনের অ্যাপ্লিকেশনের ফ্লো সম্পর্কে বিস্তারিত তথ্যের জন্য, গুগলের OAuth 2.0 ডকুমেন্টেশন দেখুন।
পোস্টমাস্টার টুলস এপিআই-এর জন্য OAuth 2.0 স্কোপের তথ্য নিচে দেওয়া হলো:
| পরিধি | অর্থ |
|---|---|
https://www.googleapis.com/auth/postmaster | পোস্টমাস্টার টুলস ডেটাতে পঠন/লিখন অ্যাক্সেসের অনুমতি দেয়। |
https://www.googleapis.com/auth/postmaster.domain | ডোমেইন তথ্যে শুধুমাত্র পঠনযোগ্য প্রবেশাধিকার দেয়। |
https://www.googleapis.com/auth/postmaster.traffic.readonly | পোস্টমাস্টার টুলস-এর ট্র্যাফিক পরিসংখ্যানে শুধুমাত্র পঠনযোগ্য অ্যাক্সেসের অনুমতি দেয়। |
OAuth 2.0 ব্যবহার করে অ্যাক্সেসের অনুরোধ করতে, আপনার অ্যাপ্লিকেশনের স্কোপ তথ্যের পাশাপাশি, অ্যাপ্লিকেশনটি নিবন্ধন করার সময় Google-এর সরবরাহ করা তথ্যেরও (যেমন ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট) প্রয়োজন হয়।