Google Ads API কল করার সময় আপনার OAuth 2.0 অ্যাপ্লিকেশনের শংসাপত্র এবং একটি বিকাশকারী টোকেন উভয়ই প্রয়োজন। আপনি যদি একটি Google বিজ্ঞাপন ম্যানেজার অ্যাকাউন্ট দিয়ে API কল করে থাকেন, তাহলে আপনাকে প্রতিটি অনুরোধের সাথে একটি login-customer-id শিরোনামও উল্লেখ করতে হবে। এই পৃষ্ঠাটি বর্ণনা করে যে কীভাবে এই মানগুলি সেট করতে হয় এবং REST ইন্টারফেস ব্যবহার করার সময় পাঠানো এবং প্রাপ্ত করা হয় এমন বেশ কয়েকটি অতিরিক্ত API-নির্দিষ্ট HTTP শিরোনাম নথিভুক্ত করা হয়।
OAuth 2.0 শংসাপত্র
Google বিজ্ঞাপন এপিআই এপিআই অনুরোধ শনাক্ত ও অনুমোদনের জন্য অ্যাপ্লিকেশনের শংসাপত্র ব্যবহার করে। OAuth 2.0 ক্লায়েন্ট এবং পরিষেবা অ্যাকাউন্ট উভয়ই কনফিগার করা যেতে পারে। ক্লায়েন্ট-সাইড অনুমোদন কনফিগার করার বিষয়ে আরও বিশদ বিবরণের জন্য, Google বিজ্ঞাপন API-এ OAuth2 দেখুন।
আপনি যদি Google API-এ নতুন হয়ে থাকেন, তাহলে আপনার অ্যাপের জন্য কোড লেখার আগে অ্যাপ্লিকেশন ক্রেডেনশিয়াল এবং Google Ads API নিয়ে পরীক্ষা করার জন্য আপনি oauth2l বা OAuth 2.0 প্লেগ্রাউন্ড ব্যবহার করতে পারেন।
ডেস্কটপ বা ওয়েব অ্যাপ ফ্লো ব্যবহার করে
Google Ads API-এর জন্য একটি Google API কনসোল প্রজেক্ট কনফিগার করতে ধাপগুলি অনুসরণ করুন। ক্লায়েন্ট আইডি এবং ক্লায়েন্ট সিক্রেট রেকর্ড করুন, তারপর এই পৃষ্ঠায় ফিরে আসুন।
একবার আপনি একটি OAuth ক্লায়েন্ট তৈরি করলে, একটি রিফ্রেশ টোকেন এবং একটি অ্যাক্সেস টোকেন তৈরি করতে ডেস্কটপ অ্যাপ ফ্লো নির্দেশাবলী বা ওয়েব অ্যাপ ফ্লো নির্দেশাবলী অনুসরণ করুন৷
পরিষেবা অ্যাকাউন্ট ব্যবহার করে
Google Ads API-এর জন্য পরিষেবা অ্যাকাউন্ট অ্যাক্সেস সেট-আপ করতে পরিষেবা অ্যাকাউন্ট গাইডে সাধারণ নির্দেশাবলী অনুসরণ করুন।
একবার আপনি আপনার Google বিজ্ঞাপন অ্যাকাউন্ট অ্যাক্সেস করার জন্য একটি পরিষেবা অ্যাকাউন্ট সেট আপ করার পরে, HTTP/REST ট্যাবটি নির্বাচন করা নিশ্চিত করে সার্ভার থেকে সার্ভার অ্যাপ্লিকেশনের জন্য OAuth 2.0 ব্যবহার করুন । Google Ads API অ্যাক্সেসের জন্য ব্যবহার করার scope হল https://www.googleapis.com/auth/adwords ।
নতুন অ্যাক্সেস টোকেন তৈরি করা হচ্ছে
একবার আপনার কাছে ক্লায়েন্ট আইডি , ক্লায়েন্ট সিক্রেট এবং রিফ্রেশ টোকেন হয়ে গেলে, আপনি 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
তারপরে আপনি Google Ads API-এ প্রতিটি API কলের Authorization HTTP শিরোনামে কার্ল অনুরোধ দ্বারা ফেরত আসা অ্যাক্সেস টোকেন ব্যবহার করুন:
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
শিরোনাম অনুরোধ করুন
বিকাশকারী টোকেন
এপিআই-এ কল করার জন্য Google বিজ্ঞাপন API-এরও একটি ডেভেলপার টোকেন প্রয়োজন। আপনি সরাসরি Google Ads UI থেকে আপনার ম্যানেজার অ্যাকাউন্টের জন্য একটি টোকেনের জন্য আবেদন করতে পারেন। একটি ডেভেলপার টোকেন দিয়ে সেট আপ করা সম্পর্কে আরও বিশদ বিবরণের জন্য, আপনার বিকাশকারী টোকেন পান দেখুন।
Google Ads API-এ প্রতিটি API কলের developer-token HTTP হেডারে আপনাকে আপনার ডেভেলপার টোকেন মান অন্তর্ভুক্ত করতে হবে:
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
লগইন গ্রাহক আইডি
ক্লায়েন্ট অ্যাকাউন্টে একজন ম্যানেজার দ্বারা করা Google Ads API কলগুলির জন্য (অর্থাৎ, ক্লায়েন্ট অ্যাকাউন্টগুলির একটিতে API কল করার জন্য ম্যানেজার হিসাবে লগ ইন করার সময়), আপনাকে login-customer-id HTTP হেডারও সরবরাহ করতে হবে। এই মানটি API কল করা ম্যানেজারের Google Ads গ্রাহক আইডিকে উপস্থাপন করে।
এই শিরোনামটি অন্তর্ভুক্ত করা সাইন ইন করার পরে বা পৃষ্ঠার উপরের-ডানদিকে আপনার প্রোফাইল ছবিতে ক্লিক করার পরে Google Ads UI-তে একটি অ্যাকাউন্ট বেছে নেওয়ার সমতুল্য। গ্রাহক আইডি নির্দিষ্ট করার সময়, যেকোনো হাইফেন (—) মুছে ফেলতে ভুলবেন না, উদাহরণস্বরূপ: 1234567890 , 123-456-7890 নয়।
GET /v17/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
প্রতিক্রিয়া শিরোনাম
নিম্নলিখিত শিরোনামগুলি API থেকে HTTP প্রতিক্রিয়াগুলিতে ফেরত দেওয়া হয়।
আইডি অনুরোধ করুন
request-id একটি স্ট্রিং যা স্বতন্ত্রভাবে API অনুরোধকে শনাক্ত করে। নির্দিষ্ট API কলগুলির সাথে ডিবাগিং বা সমস্যা সমাধানের সময়, Google বিকাশকারী সহায়তার সাথে যোগাযোগ করার সময় request-id একটি গুরুত্বপূর্ণ শনাক্তকারী।
request-id: 2a5Cj89VV7CNhya1DZjjrC