Google Ads API-তে একটি সমন্বিত অ্যাট্রিবিউট রিট্রিভাল ও মেট্রিক্স রিপোর্টিং মেকানিজম আছে যা আপনাকে Google Ads কোয়েরি ল্যাঙ্গুয়েজ ব্যবহার করে কোয়েরি তৈরি করতে দেয়। এটি জটিল কোয়েরি করার সুবিধা দেয় যা স্বতন্ত্র Google Ads অ্যাকাউন্ট সম্পর্কে বিপুল পরিমাণ ডেটা প্রদান করতে পারে।
আপনি Search বা SearchStream পদ্ধতির যেকোনও একটি ব্যবহার করে কোয়েরি তৈরি করতে পারবেন।
দুটি পদ্ধতিতেই একই কোয়েরি কাজ করে এবং একই ধরনের ফলাফল পাওয়া যায়।
Search মেথড ১০,০০০ সারির নির্দিষ্ট সাইজের পৃষ্ঠায় ডেটা রিটার্ন করে, এর ফলে আপনি
পেজিনেশন ব্যবহার করে ফলাফল সেটের উপর পুনরাবৃত্তি করতে পারেন। কম
ব্যান্ডউইথ বা নির্ভরযোগ্য নয় এমন নেটওয়ার্কের ক্ষেত্রে এটি সুবিধাজনক হতে পারে। যেমন, কোনও কানেকশন
ডিসকানেক্ট হয়ে গেলে, বড়
ফলাফল সেটকে ছোট ছোট উত্তরে ভাগ করে আবার ফেচ করা যেতে পারে। অন্যদিকে, SearchStream পদ্ধতিটি একটি একক উত্তরে সম্পূর্ণ ফলাফল সেট স্ট্রিম করে, যা বাল্ক ডেটা
পুনরুদ্ধারের জন্য আরও কার্যকর হতে পারে।
Search ও SearchStream, দু'টিই একই বেস URL ব্যবহার করে:
https://googleads.googleapis.com/v26/customers/CUSTOMER_ID/googleAds
POST /v26/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.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'" }
ফলাফলে ১০,০০০-এর বেশি সারি থাকলে, উত্তরে nextPageToken
ফেরত পাঠানো হয়:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
আগের অনুরোধ থেকে পাওয়া ভ্যালু সহ pageToken যোগ করে একই কোয়েরি আবার করলে,
ফলাফলের পরবর্তী পৃষ্ঠা পাওয়া যায়:
POST /v26/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.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'", "pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B" }
SearchStream পদ্ধতি ব্যবহার করতে, যা একটি স্ট্রিম করা
রেসপন্সে সব ফলাফল রিটার্ন করে, URL-এ পরিষেবা পদ্ধতি পরিবর্তন করে searchStream করুন
(SearchStream-এর জন্য pageToken প্রয়োজন নেই):
POST /v26/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1 Host: googleads.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'" }