Google Ads API কল করার জন্য আপনার OAuth 2.0 ক্রেডেনশিয়াল এবং একটি ডেভেলপার টোকেন উভয়ই প্রয়োজন। আপনি যদি একটি Google Ads ম্যানেজার অ্যাকাউন্ট দিয়ে API কল করেন, তাহলে প্রতিটি অনুরোধের সাথে আপনাকে একটি login-customer-id হেডারও উল্লেখ করতে হবে। এই পৃষ্ঠায় এই মানগুলি কীভাবে সেট করতে হয় তা বর্ণনা করা হয়েছে এবং REST ইন্টারফেস ব্যবহার করার সময় পাঠানো ও গ্রহণ করা হয় এমন আরও কয়েকটি API-নির্দিষ্ট HTTP হেডারের বিবরণ দেওয়া হয়েছে।
OAuth 2.0 ক্রেডেনশিয়াল
গুগল অ্যাডস এপিআই, এপিআই অনুরোধ অনুমোদনের জন্য OAuth 2.0 ব্যবহার করে। OAuth 2.0 ব্যবহারকারী প্রমাণীকরণ ফ্লো এবং সার্ভিস অ্যাকাউন্ট ফ্লো উভয়ই সমর্থিত। আরও বিস্তারিত জানতে, গুগল অ্যাডস এপিআই-তে OAuth 2.0 দেখুন।
আপনি যদি গুগল এপিআই-এর সাথে নতুন হন, তাহলে আপনার অ্যাপের জন্য কোড লেখার আগে OAuth 2.0 ক্রেডেনশিয়াল এবং গুগল অ্যাডস এপিআই নিয়ে পরীক্ষা-নিরীক্ষা করার জন্য gcloud CLI অথবা OAuth 2.0 প্লেগ্রাউন্ড ব্যবহার করতে পারেন।
OAuth 2.0 অথরাইজেশন ওয়ার্কফ্লো বাস্তবায়নের জন্য আমরা আপনাকে https://oauth.net/code/ -এ উপলব্ধ OAuth 2.0 লাইব্রেরিগুলোর মধ্যে একটি ব্যবহার করার পরামর্শ দিই। তবে, আপনার যদি এটি নিজে থেকে বাস্তবায়ন করার প্রয়োজন হয়, তার জন্য আমরা curl নির্দেশাবলী তালিকাভুক্ত করেছি।
পরিষেবা অ্যাকাউন্ট
Google Ads API-এর জন্য একটি Google Cloud প্রজেক্ট কনফিগার করতে ধাপগুলো অনুসরণ করুন। সার্ভিস অ্যাকাউন্ট ইমেল এবং সার্ভিস অ্যাকাউন্ট কী (key) লিখে রাখুন। এরপর, আপনার Google Ads অ্যাকাউন্ট অ্যাক্সেস করার জন্য সার্ভিস অ্যাকাউন্টটি সেট আপ করতে সার্ভিস অ্যাকাউন্টস গাইডের সাধারণ নির্দেশাবলী অনুসরণ করুন।
ব্যবহারকারী প্রমাণীকরণ
Google Ads API-এর জন্য একটি Google Cloud Console প্রজেক্ট কনফিগার করতে ধাপগুলো অনুসরণ করুন। ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট লিখে রাখুন। এরপর, একটি রিফ্রেশ টোকেন এবং একটি অ্যাক্সেস টোকেন তৈরি করতে ডেস্কটপ অ্যাপ ফ্লো নির্দেশাবলী অথবা ওয়েব অ্যাপ ফ্লো নির্দেশাবলী অনুসরণ করুন। Google Ads API অ্যাক্সেসের জন্য ব্যবহৃত scope হলো https://www.googleapis.com/auth/adwords ।
নতুন অ্যাক্সেস টোকেন তৈরি করুন
পরিষেবা অ্যাকাউন্ট
যখন আপনার কাছে সার্ভিস অ্যাকাউন্ট ইমেল এবং সার্ভিস অ্যাকাউন্ট কী থাকবে, তখন একটি JWT ক্লেইম সেট তৈরি করার জন্য "সার্ভার টু সার্ভার অ্যাপ্লিকেশনের জন্য OAuth 2.0 ব্যবহার" গাইডটি অনুসরণ করুন, যা বিনিময় করে একটি OAuth 2.0 অ্যাক্সেস টোকেন পাওয়া যাবে। গাইডটি অনুসরণ করার সময় HTTP/REST ট্যাবটি নির্বাচন করতে ভুলবেন না। Google Ads API অ্যাক্সেসের জন্য ব্যবহৃত OAuth 2.0 scope হলো https://www.googleapis.com/auth/adwords । এছাড়াও, JWT ক্লেইম সেট তৈরি করার সময় আপনি sub প্যারামিটারটি বাদ দিতে পারেন, কারণ সেটআপ ধাপগুলো সার্ভিস অ্যাকাউন্টকে Google Ads অ্যাকাউন্টে সরাসরি অ্যাক্সেস দেয়, ফলে কোনো Google Ads ব্যবহারকারীর ছদ্মবেশ ধারণ করার প্রয়োজন হয় না।
এরপর আপনি গুগল অ্যাডস এপিআই-তে করা প্রতিটি এপিআই কলের Authorization HTTP হেডারে অ্যাক্সেস টোকেনটি ব্যবহার করবেন:
GET /v24/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
ব্যবহারকারী প্রমাণীকরণ
একবার আপনার কাছে একটি OAuth 2.0 ক্লায়েন্ট আইডি , ক্লায়েন্ট সিক্রেট এবং রিফ্রেশ টোকেন থাকলে, আপনি curl কমান্ড লাইন টুল ব্যবহার করে API কলে ব্যবহারের জন্য একটি নতুন অ্যাক্সেস টোকেন তৈরি করতে পারেন:
curl \
--data "grant_type=refresh_token" \
--data "client_id=CLIENT_ID" \
--data "client_secret=CLIENT_SECRET" \
--data "refresh_token=REFRESH_TOKEN" \
https://www.googleapis.com/oauth2/v3/token এরপর আপনি `curl` অনুরোধের মাধ্যমে প্রাপ্ত অ্যাক্সেস টোকেনটি `Google Ads API`-তে করা প্রতিটি API কলের Authorization HTTP` হেডারে ব্যবহার করবেন:
GET /v24/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
অনুরোধ হেডার
নিম্নলিখিত বিভাগগুলিতে গুগল অ্যাডস এপিআই-তে অনুরোধ করার সময় প্রয়োজনীয় বা ব্যবহৃত HTTP হেডারগুলি বর্ণনা করা হয়েছে।
ডেভেলপার টোকেন
Google Ads API-তে কল করার জন্য একটি ডেভেলপার টোকেনও প্রয়োজন। আপনার কাছে যদি আগে থেকেই একটি ডেভেলপার টোকেন থাকে, তবে আপনি https://ads.google.com/aw/apicenter -এ গিয়ে সেটি খুঁজে নিতে পারেন। অনুরোধ করা হলে আপনার Google Ads ম্যানেজার অ্যাকাউন্টে সাইন ইন করুন। যদি আপনার কোনো অ্যাকাউন্ট না থাকে, তবে একটি ডেভেলপার টোকেনের জন্য সাইন আপ করার নির্দেশাবলী অনুসরণ করুন।
Google Ads API-তে করা প্রতিটি API কলের ক্ষেত্রে আপনাকে অবশ্যই developer-token HTTP হেডারে আপনার ডেভেলপার টোকেন ভ্যালুটি অন্তর্ভুক্ত করতে হবে:
GET /v24/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
লগইন গ্রাহক আইডি
কোনো ম্যানেজার যখন কোনো ক্লায়েন্ট অ্যাকাউন্টে গুগল অ্যাডস এপিআই কল করেন (অর্থাৎ, ম্যানেজার হিসেবে লগ ইন করে তার কোনো একটি ক্লায়েন্ট অ্যাকাউন্টে এপিআই কল করার সময়), তখন আপনাকে login-customer-id HTTP হেডারটিও সরবরাহ করতে হবে। এই ভ্যালুটি এপিআই কলকারী ম্যানেজারের গুগল অ্যাডস কাস্টমার আইডি নির্দেশ করে।
এই হেডারটি অন্তর্ভুক্ত করা, সাইন ইন করার পর গুগল অ্যাডস UI-তে একটি অ্যাকাউন্ট বেছে নেওয়া অথবা পেজের উপরের ডান কোণায় আপনার প্রোফাইল ছবিতে ক্লিক করার সমতুল্য। কাস্টমার আইডি উল্লেখ করার সময়, যেকোনো হাইফেন (—) অবশ্যই মুছে ফেলবেন। উদাহরণস্বরূপ: 1234567890 , 123-456-7890 নয়। লগইন কাস্টমার আইডি সম্পর্কে আরও জানতে গুগল অ্যাডস অ্যাক্সেস মডেল গাইডটি দেখুন।
GET /v24/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
সংযুক্ত গ্রাহক আইডি
লিঙ্ক করা Google Ads অ্যাকাউন্টে কনভার্সন আপলোড করার সময়, লিঙ্ক করা কাস্টমার আইডি হেডারটি শুধুমাত্র থার্ড-পার্টি অ্যাপ অ্যানালিটিক্স প্রোভাইডাররা ব্যবহার করে। আরও বিস্তারিত জানতে API কল স্ট্রাকচার গাইড দেখুন।
...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID
প্রতিক্রিয়া হেডার
এপিআই থেকে প্রাপ্ত HTTP রেসপন্সে নিম্নলিখিত হেডারগুলো ফেরত আসে।
অনুরোধ আইডি
request-id হলো একটি স্ট্রিং যা এপিআই রিকোয়েস্টকে অনন্যভাবে শনাক্ত করে। নির্দিষ্ট এপিআই কলের সমস্যা ডিবাগ বা ট্রাবলশুটিং করার সময়, গুগল ডেভেলপার সাপোর্টের সাথে যোগাযোগ করার জন্য request-id একটি গুরুত্বপূর্ণ শনাক্তকারী যা হাতের কাছে থাকা প্রয়োজন।
request-id: 2a5Cj89VV7CNhya1DZjjrC