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