Google Ads API কল করার সময় আপনার OAuth 2.0 ক্রেডেনশিয়াল প্রয়োজন। আপনি Google Ads ম্যানেজার অ্যাকাউন্টের মাধ্যমে API
কল করলে, প্রতিটি অনুরোধের সাথে আপনাকে login-customer-id হেডারও
উল্লেখ করতে হবে। এই পৃষ্ঠা বর্ণনা করে যে কীভাবে এই মানগুলি সেট করতে হয় এবং REST ইন্টারফেস ব্যবহার করার সময় পাঠানো এবং
পাওয়া বেশ কয়েকটি অতিরিক্ত API-নির্দিষ্ট HTTP হেডার ডকুমেন্ট করে।
OAuth 2.0 ক্রেডেনশিয়াল
API অনুরোধ অনুমোদন করার জন্য Google Ads API, OAuth 2.0 ব্যবহার করে। OAuth 2.0 ব্যবহারকারী যাচাইকরণ ফ্লো এবং পরিষেবা অ্যাকাউন্ট ফ্লো দু'টিই কাজ করে। আরও বিবরণের জন্য, Google Ads API-তে OAuth 2.0 দেখুন।
আপনি Google API-এ নতুন হলে, আপনার অ্যাপের জন্য কোড লেখার আগে OAuth 2.0 ক্রেডেনশিয়াল এবং Google Ads API নিয়ে পরীক্ষা করতে gcloud CLI বা OAuth 2.0 Playground ব্যবহার করতে পারেন।
OAuth 2.0 অনুমোদনের ওয়ার্কফ্লো প্রয়োগ করতে, আমরা আপনাকে https://oauth.net/code/ লিঙ্কে উপলভ্য OAuth 2.0 লাইব্রেরিগুলির মধ্যে কোনও একটি ব্যবহার করার সাজেশন দিই। তবে, আপনি নিজে এটি প্রয়োগ করতে চাইলে, আমরা curl নির্দেশাবলী তালিকাভুক্ত করেছি।
পরিষেবা অ্যাকাউন্ট
Google Ads API-এর জন্য Google Cloud প্রোজেক্ট কনফিগার করতে ধাপগুলি অনুসরণ করুন। পরিষেবা অ্যাকাউন্টের ইমেল এবং পরিষেবা অ্যাকাউন্টের কী রেকর্ড করুন। এরপর, আপনার 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 ব্যবহারকারীর
ছদ্মবেশ ধারণ করার প্রয়োজন হয় না।
তারপরে, Google Ads API-তে করা প্রতিটি API কলের Authorization HTTP হেডার
থেকে অ্যাক্সেস টোকেন ব্যবহার করুন:
GET /v26/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_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তারপর আপনি Google Ads API-তে প্রতিটি API কলের Authorization HTTP হেডারে curl অনুরোধের মাধ্যমে ফেরত পাঠানো অ্যাক্সেস টোকেন ব্যবহার করেন:
GET /v26/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
অনুরোধের হেডার
Google Ads API-তে অনুরোধ করার সময় প্রয়োজনীয় বা ব্যবহৃত HTTP হেডার সম্পর্কে নিম্নলিখিত বিভাগে বর্ণনা করা হয়েছে।
লগ-ইন কাস্টমার আইডি
ম্যানেজার কোনও ক্লায়েন্ট অ্যাকাউন্টে Google Ads API কল করলে (অর্থাৎ, কোনও ক্লায়েন্ট অ্যাকাউন্টে API কল করার জন্য ম্যানেজার হিসেবে লগ-ইন করলে), আপনাকে login-customer-id HTTP হেডারও প্রদান করতে হবে। এই ভ্যালু API কল করা ম্যানেজারকে দেওয়া Google Ads
কাস্টমার আইডিকে বোঝায়।
এই হেডার যোগ করা মানে Google Ads UI-তে
সাইন-ইন করার পরে বা পৃষ্ঠার
উপরে ডানদিকের কোণে আপনার প্রোফাইল ছবিতে ক্লিক করে অ্যাকাউন্ট বেছে নেওয়া। কাস্টমার আইডি উল্লেখ করার সময়, কোনও হাইফেন (—) থাকলে তা সরিয়ে দিতে ভুলবেন না। যেমন: 1234567890, 123-456-7890 নয়। লগ-ইন কাস্টমার আইডি সম্পর্কে আরও জানতে Google Ads অ্যাক্সেস মডেল
গাইড দেখুন।
GET /v26/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
লিঙ্ক করা কাস্টমার আইডি
লিঙ্ক করা Google Ads অ্যাকাউন্টে কাজ করার সময় পার্টনাররা (যেমন থার্ড-পার্টি অ্যাপ অ্যানালিটিক্স প্রদানকারী বা ডেটা পার্টনার) লিঙ্ক করা কাস্টমার আইডি হেডার ব্যবহার করে। আরও তথ্যের জন্য API কল স্ট্রাকচার গাইড দেখুন।
Authorization: Bearer ACCESS_TOKEN
login-customer-id: PARTNER_CUSTOMER_ID
linked-customer-id: ADVERTISER_CUSTOMER_ID
রেসপন্স হেডার
API থেকে HTTP রেসপন্সে নিম্নলিখিত হেডার ফেরত দেওয়া হয়।
অনুরোধ আইডি
request-id হল একটি স্ট্রিং যা API অনুরোধকে অনন্যভাবে শনাক্ত করে। নির্দিষ্ট API কলের সাথে সমস্যা
ডিবাগ বা সমস্যা সমাধান করার সময়, Google ডেভেলপার
সহায়তার সাথে যোগাযোগ করার সময় request-id
একটি গুরুত্বপূর্ণ শনাক্তকারী হিসেবে সাথে রাখা প্রয়োজন।
request-id: 2a5Cj89VV7CNhya1DZjjrC