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