অনুমোদন ও HTTP হেডার

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, API অনুরোধ শনাক্ত ও অনুমোদন করার জন্য অ্যাপ্লিকেশন ক্রেডেনশিয়াল ব্যবহার করে। OAuth 2.0 ক্লায়েন্ট কনফিগার করা যেতে পারে। সব Search Ads 360 Reporting API কল OAuth2-এর মাধ্যমে অনুমোদিত হতে হবে। OAuth2 আপনার Search Ads 360 Reporting API ক্লায়েন্ট অ্যাপকে ব্যবহারকারীর লগ-ইন তথ্য ম্যানেজ বা স্টোর না করেই ব্যবহারকারীর Search Ads 360 অ্যাকাউন্ট অ্যাক্সেস করার অনুমতি দেয়।

আপনি Google API-এ নতুন হলে, অ্যাপের জন্য কোড লেখার আগে অ্যাপ্লিকেশন ক্রেডেনশিয়াল এবং Search Ads 360 Reporting API নিয়ে পরীক্ষা করতে oauth2l বা OAuth 2.0 Playground ব্যবহার করতে পারেন। এছাড়াও, আপনি প্রদত্ত ব্যবহারকারীর ক্রেডেনশিয়াল জেনারেশন স্ক্রিপ্ট রান করে 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

তারপর আপনি curl অনুরোধের মাধ্যমে ফেরত পাওয়া অ্যাক্সেস টোকেন Search Ads 360 Reporting API-তে প্রতিটি API কলের Authorization HTTP হেডারে ব্যবহার করেন:

GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN

রিকোয়েস্ট হেডার

লগ-ইন কাস্টমার আইডি

ম্যানেজার কোনও ক্লায়েন্ট অ্যাকাউন্টে Search Ads 360 রিপোর্টিং API কল করলে (অর্থাৎ, কোনও ক্লায়েন্ট অ্যাকাউন্টে API কল করার জন্য ম্যানেজার হিসেবে লগ-ইন করলে), আপনাকে login-customer-id HTTP হেডারও প্রদান করতে হবে। এই ভ্যালু API কল করা ম্যানেজারের Search Ads 360 কাস্টমার আইডি দেখায়।

এই হেডার অন্তর্ভুক্ত করার অর্থ হল, সাইন-ইন করার পরে Search Ads 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