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