Google Ads API-তে একটি ইউনিফাইড অ্যাট্রিবিউট রিট্রিভাল এবং মেট্রিক্স রিপোর্টিং মেকানিজম রয়েছে যা আপনাকে Google Ads Query Language ব্যবহার করে কোয়েরি তৈরি করতে দেয়। এটি জটিল কোয়েরিগুলিকে সক্ষম করে যা পৃথক Google Ads অ্যাকাউন্ট সম্পর্কে প্রচুর পরিমাণে ডেটা ফেরত দিতে পারে।
আপনি Search অথবা SearchStream পদ্ধতি ব্যবহার করে কোয়েরি তৈরি করতে পারেন। উভয় পদ্ধতিই একই কোয়েরি সমর্থন করে এবং সমতুল্য ফলাফল প্রদান করে। Search পদ্ধতিটি 10,000 সারির নির্দিষ্ট আকারের পৃষ্ঠাগুলিতে ডেটা প্রদান করে, যা আপনাকে পৃষ্ঠাঙ্কন ব্যবহার করে একটি ফলাফল সেটের উপর পুনরাবৃত্তি করতে সক্ষম করে। এটি কম ব্যান্ডউইথ বা অবিশ্বস্ত নেটওয়ার্ক পরিস্থিতিতে সুবিধাজনক হতে পারে, উদাহরণস্বরূপ, একটি বৃহৎ ফলাফল সেটকে ছোট প্রতিক্রিয়াগুলিতে ভাগ করা যা সংযোগ বিচ্ছিন্ন হলে পুনরায় আনা যেতে পারে। অন্যদিকে, SearchStream পদ্ধতিটি সম্পূর্ণ ফলাফল সেটটিকে একটি একক প্রতিক্রিয়াতে স্ট্রিম করে, যা বাল্ক ডেটা পুনরুদ্ধারের জন্য আরও কার্যকর হতে পারে।
Search এবং SearchStream উভয়ই একই বেস URL ব্যবহার করে:
https://googleads.googleapis.com/v22/customers/CUSTOMER_ID/googleAds
POST /v22/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_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 /v22/customers/CUSTOMER_ID/googleAds:search HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_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 এ পরিবর্তন করুন ( pageToken SearchStream দ্বারা প্রয়োজনীয় নয়):
POST /v22/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_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'" }