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'" }