Search Ads 360 Reporting API-তে কলগুলি সাধারণত আপনার ক্লায়েন্ট লাইব্রেরির মাধ্যমে করা হয়। আরও তথ্যের জন্য ব্যাখ্যা করা ক্লায়েন্ট লাইব্রেরি দেখুন। যাইহোক, অন্তর্নিহিত অনুরোধের বিবরণের গঠন সম্পর্কে জ্ঞান পরীক্ষা এবং ডিবাগ করার সময় কার্যকর হতে পারে।
Search Ads 360 Reporting API হল REST বাইন্ডিং সহ একটি gRPC API । এর মানে হল যে আপনি দুটি বিকল্প উপায়ে API এ কল করতে পারেন:
- পছন্দের পদ্ধতি
- একটি ক্লায়েন্ট লাইব্রেরি ব্যবহার করুন:
- একটি প্রোটোকল বাফার হিসাবে অনুরোধের মূল অংশ তৈরি করুন।
- HTTP/2 ব্যবহার করে সার্ভারে অনুরোধ পাঠান।
- একটি প্রোটোকল বাফার প্রতিক্রিয়া deserialize.
- ফলাফল ব্যাখ্যা.
- ঐচ্ছিক বিকল্প পদ্ধতি
- REST ব্যবহার করুন:
- একটি JSON অবজেক্ট হিসাবে অনুরোধের বডি তৈরি করুন।
- HTTP 1.1 ব্যবহার করে সার্ভারে অনুরোধ পাঠান।
- একটি JSON অবজেক্ট হিসাবে প্রতিক্রিয়া deserialize.
- ফলাফল ব্যাখ্যা.
আরও তথ্যের জন্য Google Cloud APIs দেখুন।
নিম্নলিখিত বিভাগগুলি gRPC এবং REST উভয় প্রোটোকলের ক্ষেত্রেই প্রযোজ্য।
সম্পদের নাম
API-এর বেশিরভাগ অবজেক্ট তাদের রিসোর্স নামের স্ট্রিং দ্বারা চিহ্নিত করা হয়। REST ইন্টারফেস ব্যবহার করার সময় এই স্ট্রিংগুলি URL হিসাবেও কাজ করে।
সমর্থিত সংস্থান এবং তাদের পথ উপস্থাপনা সম্পর্কে আরও তথ্যের জন্য রেফারেন্স > REST দেখুন। একই বিন্যাস অন্যান্য পরিষেবার জন্য ব্যবহার করা হয়.
কম্পোজিট আইডি
যদি কোনো বস্তুর আইডি বিশ্বব্যাপী অনন্য না হয়, তাহলে সেই বস্তুর জন্য একটি যৌগিক আইডি তৈরি করা হয় তার মূল আইডি এবং একটি টিল্ড (~) পূর্বে রেখে।
উদাহরণস্বরূপ, যেহেতু একটি বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপন আইডি বিশ্বব্যাপী অনন্য নয়, তাই মূল অবজেক্ট (বিজ্ঞাপন গোষ্ঠী) আইডিটি এটির সাথে যুক্ত থাকে যার ফলে একটি অনন্য কম্পোজিট আইডি তৈরি হয়।
উদাহরণ: 123 এর AdGroupId + ~ + 45678 এর AdGroupAdId = 123~45678 এর যৌগিক বিজ্ঞাপন গোষ্ঠীর বিজ্ঞাপন ID।
শিরোনাম অনুরোধ করুন
নিম্নলিখিত বিভাগে HTTP হেডার (বা gRPC মেটাডেটা ) অনুরোধের মূল অংশে অন্তর্ভুক্ত করা উচিত।
অনুমোদন
আপনাকে ফর্মটিতে একটি OAuth2 অ্যাক্সেস টোকেন অন্তর্ভুক্ত করতে হবে:
Authorization: Bearer [OAUTH_2.0_ACCESS_TOKEN]
টোকেনটি একটি ক্লায়েন্টের পক্ষে কাজ করে এমন একটি ম্যানেজার অ্যাকাউন্ট বা বিজ্ঞাপনদাতাকে সরাসরি তাদের নিজস্ব সাব-ম্যানেজার বা ক্লায়েন্ট অ্যাকাউন্ট পরিচালনা করে সনাক্ত করা উচিত। আরও জানতে Search Ads 360 ম্যানেজার অ্যাকাউন্ট এবং প্রমাণীকরণ সম্পর্কে দেখুন।
লগইন গ্রাহক আইডি শিরোনাম
একটি সাব-ম্যানেজার বা ক্লায়েন্ট অ্যাকাউন্ট অ্যাক্সেস করার জন্য ম্যানেজার অ্যাকাউন্ট ব্যবহার করার সময় login-customer-id শিরোনাম প্রয়োজন। একটি সাব-ম্যানেজার বা ক্লায়েন্ট অ্যাকাউন্ট সরাসরি অ্যাক্সেস করার সময় এটি প্রয়োজন হয় না। যদিও কঠোরভাবে প্রয়োজনীয় নয়, আমরা সবসময় সুপারিশ করি যে প্রমাণীকৃত ব্যবহারকারীদের জন্য login-customer-id নির্দিষ্ট করুন যাদের একাধিক অ্যাকাউন্টে অ্যাক্সেস রয়েছে। এটি অস্পষ্টতা এড়ায় এবং অনিচ্ছাকৃতভাবে প্রসঙ্গটি ভুল অ্যাকাউন্টে সেট করা প্রতিরোধ করে।
অনুরোধে অনুমোদিত ব্যবহারকারীর গ্রাহক আইডি অন্তর্ভুক্ত করা উচিত, হাইফেন ( - ) ছাড়াই, উদাহরণস্বরূপ:
https://searchads360.googleapis.com/VERSION_NUMBER/customers/CUSTOMER_ID/campaignBudgets
login-customer-id সেট করা হল সাইন ইন করার পরে বা উপরের ডানদিকে আপনার প্রোফাইল ছবিতে ক্লিক করার পরে অনুসন্ধান বিজ্ঞাপন 360 UI-তে একটি অ্যাকাউন্ট বেছে নেওয়ার সমতুল্য।
প্রতিক্রিয়া শিরোনাম
নিম্নলিখিত শিরোনামগুলি (বা gRPC ট্রেইলিং-মেটাডেটা ) প্রতিক্রিয়া বডি সহ ফেরত দেওয়া হয়৷ আমরা সুপারিশ করি যে আপনি ডিবাগিং উদ্দেশ্যে এই মানগুলি লগ করুন৷
আইডি অনুরোধ করুন
request-id শিরোনাম হল একটি স্ট্রিং যা অনুরোধটিকে অনন্যভাবে সনাক্ত করে।