সমস্ত গুগল অ্যাড ম্যানেজার এপিআই কল অবশ্যই OAuth2- এর মাধ্যমে অনুমোদিত হতে হবে। এটি একটি উন্মুক্ত স্ট্যান্ডার্ড যা ব্যবহারকারীদের তৃতীয় পক্ষের অ্যাপ্লিকেশনগুলিকে অনুমতি দেওয়ার সুযোগ দেয়, যাতে অ্যাপ্লিকেশনটি ব্যবহারকারীর পক্ষ থেকে ওয়েব পরিষেবাগুলির সাথে যোগাযোগ করতে পারে। OAuth2 আপনার অ্যাড ম্যানেজার এপিআই ক্লায়েন্ট অ্যাপ্লিকেশনকে ব্যবহারকারীর ইউজারনেম বা পাসওয়ার্ড পরিচালনা বা সংরক্ষণ না করেই তার অ্যাড ম্যানেজার অ্যাকাউন্ট অ্যাক্সেস করতে সক্ষম করে।
OAuth2 ক্রেডেনশিয়াল তৈরি করুন
OAuth2 ক্রেডেনশিয়াল তৈরি করতে নিম্নলিখিত ধাপগুলো অনুসরণ করুন।
১. আপনার প্রমাণীকরণের ধরণ নির্ধারণ করুন
আপনার অ্যাড ম্যানেজার এপিআই অ্যাপ্লিকেশনের জন্য কোন প্রমাণীকরণ ধরণটি সবচেয়ে উপযুক্ত, তা দেখতে নিচের সারণিটি দেখুন:
| আপনার OAuth2 প্রমাণীকরণের ধরণ বেছে নিন | |
|---|---|
| পরিষেবা অ্যাকাউন্ট | আপনার যদি শুধু নিজের বিজ্ঞাপন ব্যবস্থাপকের ডেটাতে প্রবেশাধিকার প্রয়োজন হয়, তবে এটি বেছে নিন। আরও জানুন। |
| ওয়েব অ্যাপ্লিকেশন | আপনি যদি এমন কোনো ব্যবহারকারী হিসেবে প্রমাণীকরণ করতে চান যিনি আপনার অ্যাপ্লিকেশনকে তাঁর অ্যাড ম্যানেজার ডেটা অ্যাক্সেস করার অনুমতি দেন, তাহলে এটি নির্বাচন করুন। আরও জানুন। |
২. OAuth2 ক্রেডেনশিয়াল তৈরি করুন
আপনার প্রমাণীকরণের ধরণ নির্ধারণ করার পরে, নীচের সংশ্লিষ্ট ট্যাবে ক্লিক করুন এবং OAuth2 ক্রেডেনশিয়াল তৈরি করতে নির্দেশাবলী অনুসরণ করুন:
- Google API কনসোল ক্রেডেনশিয়াল পৃষ্ঠাটি খুলুন।
- প্রজেক্ট ড্রপ-ডাউন থেকে ‘Create a new project’ বেছে নিন, প্রজেক্টের জন্য একটি নাম লিখুন এবং ইচ্ছামত, প্রদত্ত প্রজেক্ট আইডিটি সম্পাদনা করুন। ‘Create’ বাটনে ক্লিক করুন।
- ক্রেডেনশিয়ালস পৃষ্ঠায়, ' ক্রিয়েট ক্রেডেনশিয়ালস' নির্বাচন করুন, তারপর 'সার্ভিস অ্যাকাউন্ট কী' নির্বাচন করুন।
- নতুন পরিষেবা অ্যাকাউন্ট নির্বাচন করুন এবং JSON নির্বাচন করুন।
- প্রাইভেট কী সম্বলিত ফাইলটি ডাউনলোড করতে Create-এ ক্লিক করুন।
- Google API কনসোল ক্রেডেনশিয়াল পৃষ্ঠাটি খুলুন।
- প্রজেক্ট ড্রপ-ডাউন থেকে ‘Create a new project’ বেছে নিন, প্রজেক্টের জন্য একটি নাম লিখুন (এবং ঐচ্ছিকভাবে, প্রদত্ত প্রজেক্ট আইডিটি সম্পাদনা করুন), এবং ‘Create’ এ ক্লিক করুন।
- ক্রেডেনশিয়ালস পেজে, 'Create credentials' নির্বাচন করুন, তারপর 'OAuth client ID' নির্বাচন করুন।
- সম্মতি স্ক্রিন পৃষ্ঠায় আপনাকে একটি পণ্যের নাম সেট করতে বলা হতে পারে; যদি তা হয়, তাহলে ‘সম্মতি স্ক্রিন কনফিগার করুন’ (Configure consent screen) -এ ক্লিক করুন, অনুরোধ করা তথ্য সরবরাহ করুন এবং ক্রেডেনশিয়াল পৃষ্ঠায় ফিরে যেতে ‘সংরক্ষণ করুন’ (Save) -এ ক্লিক করুন।
- অ্যাপ্লিকেশন টাইপের জন্য ওয়েব অ্যাপ্লিকেশন নির্বাচন করুন। জাভাস্ক্রিপ্ট অরিজিন, রিডাইরেক্ট ইউআরআই, অথবা উভয়ই প্রবেশ করানোর জন্য নির্দেশাবলী অনুসরণ করুন।
- তৈরি করুন- এ ক্লিক করুন।
- প্রদর্শিত পৃষ্ঠাটি থেকে ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট আপনার ক্লিপবোর্ডে কপি করে নিন, কারণ আপনার ক্লায়েন্ট লাইব্রেরি কনফিগার করার সময় এগুলোর প্রয়োজন হবে।
৩. আপনার বিজ্ঞাপন ব্যবস্থাপক নেটওয়ার্ক কনফিগার করুন
আপনি যদি একজন থার্ড-পার্টি ডেভেলপার হন, তাহলে এই ধাপটি আপনার ক্লায়েন্টকে দিয়ে করিয়ে নেওয়ার প্রয়োজন হতে পারে।
- আপনার বিজ্ঞাপন ব্যবস্থাপক নেটওয়ার্কে যান।
- অ্যাডমিন ট্যাবে ক্লিক করুন।
- এপিআই অ্যাক্সেস সক্রিয় আছে কিনা তা নিশ্চিত করুন।
- "Add a service account user" বোতামটিতে ক্লিক করুন।
- সার্ভিস অ্যাকাউন্ট ইমেল ব্যবহার করে ফর্মটি পূরণ করুন। সার্ভিস অ্যাকাউন্ট ব্যবহারকারীকে অবশ্যই এনটিটিগুলো অ্যাক্সেস করার অনুমতি দিতে হবে, ঠিক যেমনভাবে সেই সার্ভিস অ্যাকাউন্ট ব্যবহারকারী UI-তে এনটিটিগুলো অ্যাক্সেস করে থাকেন।
- সেভ বাটনে ক্লিক করুন। আপনার সার্ভিস অ্যাকাউন্টটি যুক্ত হওয়ার বিষয়টি নিশ্চিত করে একটি মেসেজ প্রদর্শিত হবে।
- বিদ্যমান সার্ভিস অ্যাকাউন্ট ব্যবহারকারীদের দেখতে, ইউজার্স ট্যাবে গিয়ে সার্ভিস অ্যাকাউন্ট ফিল্টারটিতে ক্লিক করুন।
- আপনার বিজ্ঞাপন ব্যবস্থাপক নেটওয়ার্কে যান।
- অ্যাডমিন ট্যাবে ক্লিক করুন।
- এপিআই অ্যাক্সেস সক্রিয় আছে কিনা তা নিশ্চিত করুন।
৪. একটি ক্লায়েন্ট লাইব্রেরি কনফিগার এবং ব্যবহার করুন
আপনার ক্লায়েন্ট লাইব্রেরিতে ক্রেডেনশিয়ালগুলি ব্যবহার করতে নীচের উপযুক্ত নির্দেশিকা অনুসরণ করুন:
জাভা
.NET
পাইথন
পিএইচপি
রুবি
আপনি যদি আমাদের কোনো ক্লায়েন্ট লাইব্রেরি ব্যবহার না করার সিদ্ধান্ত নেন, তাহলে আপনাকে নিজেই OAuth2 সার্ভিস অ্যাকাউন্ট অথবা ওয়েব অ্যাপ ফ্লো বাস্তবায়ন করতে হবে।
পর্দার আড়ালে
আমাদের ক্লায়েন্ট লাইব্রেরিগুলো নীচে বর্ণিত খুঁটিনাটি বিষয়গুলো স্বয়ংক্রিয়ভাবে সামলে নেয়, তাই নেপথ্যে কী ঘটছে তা জানতে আগ্রহী হলেই কেবল পড়তে থাকুন। এই অংশটি সেইসব অভিজ্ঞ ব্যবহারকারীদের জন্য, যারা ইতিমধ্যেই OAuth2 স্পেসিফিকেশনের সাথে পরিচিত এবং Google API-এর সাথে OAuth2 ব্যবহার করতে জানেন।
HTTP অনুরোধ হেডার
অ্যাড ম্যানেজার এপিআই-তে করা প্রতিটি অনুরোধের HTTP হেডারে অবশ্যই এই ফর্মে একটি অ্যাক্সেস টোকেন অন্তর্ভুক্ত থাকতে হবে:
Authorization: Bearer ACCESS_TOKEN
উদাহরণস্বরূপ:
POST … HTTP/1.1 Host: … Authorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg Content-Type: text/xml;charset=UTF-8 Content-Length: … <?xml version="1.0"?> <soap:Envelope xmlns:soap="http://www.w3.org/2001/12/soap-envelope"> … </soap:Envelope>
পরিধি
একটিমাত্র অ্যাক্সেস টোকেন একাধিক এপিআই-তে বিভিন্ন মাত্রার অ্যাক্সেস প্রদান করতে পারে। scope নামক একটি পরিবর্তনশীল প্যারামিটার সেই সমস্ত রিসোর্স এবং অপারেশন নিয়ন্ত্রণ করে, যা একটি অ্যাক্সেস টোকেন অনুমোদন করে। অ্যাক্সেস টোকেনের অনুরোধ করার সময়, আপনার অ্যাপ্লিকেশনটি scope প্যারামিটারে এক বা একাধিক ভ্যালু পাঠায়।
অ্যাড ম্যানেজারের কেবল একটিই পরিধি রয়েছে, যা নিচে দেখানো হলো। প্রোডাক্টের মধ্যে ব্যবহারকারী পর্যায়ে অনুমোদন সম্পন্ন করতে হবে।
| পরিধি | অনুমতি |
|---|---|
https://www.googleapis.com/auth/admanager | অ্যাড ম্যানেজারে আপনার ক্যাম্পেইনগুলো দেখুন ও পরিচালনা করুন। |