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