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