Search Ads 360 Reporting API-তে একটি ইউনিফায়েড অ্যাট্রিবিউট রিট্রিভাল ও মেট্রিক্স রিপোর্টিং মেকানিজম আছে যা আপনাকে Search Ads 360 কোয়েরি ল্যাঙ্গুয়েজ ব্যবহার করে কোয়েরি তৈরি করতে দেয়। এটি জটিল কোয়েরি করার সুবিধা দেয় যা প্রতিটি Search Ads 360 অ্যাকাউন্ট সম্পর্কে প্রচুর পরিমাণে ডেটা প্রদান করতে পারে।
আপনি Search বা SearchStream পদ্ধতির যেকোনও একটি ব্যবহার করে কোয়েরি তৈরি করতে পারবেন।
দুটি পদ্ধতিই একই কোয়েরি সাপোর্ট করে এবং একই ফলাফল দেখায়। Search
পদ্ধতি কাস্টমাইজ করা যায় এমন পৃষ্ঠার সাইজে ডেটা রিটার্ন করে, যা আপনাকে পেজিনেশন ব্যবহার করে
ফলাফলের সেটের উপর ইটারেট করতে দেয়। এটি কম ব্যান্ডউইথ বা নির্ভরযোগ্য নয় এমন নেটওয়ার্কের ক্ষেত্রে সুবিধাজনক হতে পারে,
যেমন, বড় ফলাফল সেটকে ছোট ছোট উত্তরে ভাগ করা,
যাতে কানেকশন হারিয়ে গেলে আবার ফেচ করা যায়। অন্যদিকে,
SearchStream পদ্ধতি, একটি উত্তরে সম্পূর্ণ ফলাফল সেট স্ট্রিম করে, যা বাল্ক ডেটা ফিরিয়ে আনার জন্য আরও দক্ষ হতে পারে।
Search এবং SearchStream, দুটিই একই বেস URL ব্যবহার করে:
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360
পৃষ্ঠা-ভিত্তিক সার্চ পদ্ধতিতে একটি ঐচ্ছিক pageSize প্যারামিটার থাকে যা
একটি API রেসপন্সে কতগুলি ফলাফল দেখানো হবে তা সীমিত করে।
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchAds360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }
ফলাফলে pageSize-এর থেকে বেশি সারি থাকলে, উত্তরে nextPageToken
ফেরত পাঠানো হয়:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
উপরে উল্লেখ করা ভ্যালুর সাথে pageToken যোগ করে একই কোয়েরি আবার করলে
পরবর্তী পৃষ্ঠার ফলাফল পাওয়া যায়:
POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "pageSize": 10000, "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'", "pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B" }
SearchStream পদ্ধতি ব্যবহার করতে, যা একটি একক স্ট্রিম করা উত্তরে সমস্ত ফলাফল প্রদান করে, URL-এ পরিষেবা পদ্ধতিটি পরিবর্তন করে searchStream করুন
(pageSize এবং pageToken SearchStream-এর জন্য প্রয়োজন নেই):
POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1 Host: searchads360.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN { "query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'" }