আপনি GoogleAdsFieldService
(GetGoogleAdsField বা SearchGoogleAdsFields-এর মাধ্যমে) ব্যবহার করে
GoogleAdsService Search
এবং SearchStream পদ্ধতিতে উপলভ্য রিসোর্সের ক্যাটালগ, রিসোর্স ফিল্ড, সেগমেন্টেশন কী এবং মেট্রিক্সের জন্য
ডায়নামিক অনুরোধ করতে পারবেন। ক্যাটালগ মেটাডেটা প্রদান করে যা Google Ads API ক্লায়েন্টরা Google Ads কোয়েরি ল্যাঙ্গুয়েজ স্টেটমেন্ট যাচাই ও তৈরি করার জন্য ব্যবহার করতে পারে।
HTTP অনুরোধ ও উত্তরের নমুনা
অনুরোধে Google Ads API সার্ভারে একটি HTTP GET থাকে যা নিম্নলিখিত URL-এ
পাঠানো হয়:
https://googleads.googleapis.com/v26/googleAdsFields/{resource_or_field}
নিম্নলিখিত উদাহরণে একটি অনুরোধ দেখানো হয়েছে এবং তারপরে ad_group রিসোর্সের জন্য
GoogleAdsFieldService থেকে পাওয়া উত্তর দেখানো হয়েছে:
অনুরোধ করুন
https://googleads.googleapis.com/v26/googleAdsFields/ad_group
রেসপন্স
{
"resourceName": "googleAdsFields/ad_group",
"name": "ad_group",
"category": "RESOURCE",
"selectable": false,
"filterable": false,
"sortable": false,
"selectableWith": [
"campaign",
"customer",
"metrics.average_cpc",
"segments.device"
],
"attributeResources": [
"customer",
"campaign"
],
"metrics": [
"metrics.conversions",
"metrics.search_budget_lost_impression_share",
"metrics.average_cost",
"metrics.clicks"
],
"segments": [
"segments.date",
"segments.ad_network_type",
"segments.device"
]
}
এই উদাহরণের জন্য, গুরুত্বপূর্ণ অ্যারেগুলি হল:
attributeResources- যেসব রিসোর্সকে মেট্রিক্স ভাগ না করেই
FROMক্লজের রিসোর্সের সাথে অন্তর্নিহিতভাবে যোগ করা যেতে পারে। শুধুমাত্র সেইসব ফিল্ডের জন্য পপুলেট করা হয় যেখানেcategoryহলRESOURCE। metrics- মেট্রিক যা
FROMক্লজে রিসোর্সের সাথে বেছে নেওয়ার জন্য উপলভ্য। শুধুমাত্র সেইসব ফিল্ডের জন্য পপুলেট করা হয় যেখানেcategoryহলRESOURCE। segments- সেগমেন্ট কী (
segments.*ফিল্ড ও সেগমেন্ট করার রিসোর্স) যাFROMক্লজে রিসোর্সের সাথে বেছে নেওয়া যেতে পারে। এগুলি কোয়েরিতে উল্লেখ করা মেট্রিককে ভাগ করে। শুধুমাত্র সেইসব ফিল্ডের জন্য পপুলেট করা হয় যেখানেcategoryহলRESOURCE। selectableWith- রিসোর্স, সেগমেন্ট বা মেট্রিক যা একই Google Ads কোয়েরি ল্যাঙ্গুয়েজ কোয়েরিতে বেছে নেওয়া যেতে পারে
যখন এই রিসোর্স বা সেগমেন্ট
FROMক্লজে প্রাথমিক রিসোর্স নয়।
selectableWith-এর সাথে কোয়েরি কম্প্যাটিবিলিটি
রিসোর্স বা সেগমেন্ট ফিল্ডে selectableWith অ্যাট্রিবিউট অন্যান্য রিসোর্স, সেগমেন্ট বা মেট্রিক নির্দিষ্ট করে যা একই Google Ads কোয়েরি ল্যাঙ্গুয়েজ কোয়েরিতে বেছে নেওয়া যেতে পারে।
FROM ক্লজে উল্লেখ করা নেই এমন রিসোর্স বা সেগমেন্ট থেকে ফিল্ড অন্তর্ভুক্ত করতে চাইলে, এই অ্যাট্রিবিউটটি অত্যন্ত গুরুত্বপূর্ণ।
Google Ads কোয়েরি ল্যাঙ্গুয়েজ কোয়েরি তৈরি করার সময়:
FROMক্লজে রিসোর্স হল প্রাথমিক এন্টিটি। আপনি সবসময় এই রিসোর্স থেকে ফিল্ড বেছে নিতে পারবেন।- এছাড়াও, আপনি প্রাইমারি এন্টিটির সাথে উপলভ্য মানানসই মেট্রিক ও সেগমেন্ট বেছে নিতে পারবেন।
- আপনি যদি
FROMক্লজের বাইরে কোনও রিসোর্স বা সেগমেন্ট থেকে ফিল্ড অন্তর্ভুক্ত করেন, তাহলে আপনাকে অবশ্যই নিশ্চিত করতে হবে যে এই নন-FROMরিসোর্স বা সেগমেন্টটি কোয়েরিতে বেছে নেওয়া অন্যান্য সমস্ত ফিল্ড, সেগমেন্ট এবং মেট্রিকের সাথে মানানসই।
নির্দিষ্ট রিসোর্সের (রিসোর্স A) জন্য selectableWith তালিকায় অন্যান্য সব রিসোর্স, সেগমেন্ট ও মেট্রিক থাকে যা রিসোর্স A প্রাথমিক এন্টিটি না হলে রিসোর্স A-এর ফিল্ডের পাশাপাশি বেছে নেওয়া যেতে পারে।
উদাহরণ
এই উদাহরণ কোয়েরিটি বিবেচনা করুন:
SELECT ad_group.id, segments.date, campaign.name FROM ad_group
FROMক্লজad_groupনির্দিষ্ট করে।- এই কোয়েরি
ad_group.id(FROMরিসোর্স থেকে),segments.dateএবংcampaign.nameবেছে নেয়। - কারণ
campaign.nameবেছে নেওয়া হয়েছে, কিন্তুcampaignFROMক্লজে নেই, আপনাকে অবশ্যই অন্যান্য বেছে নেওয়া এলিমেন্টের সাথে এর কম্প্যাটিবিলিটি যাচাই করতে হবে। - এই কোয়েরি সঠিক কিনা তা নিশ্চিত করতে,
campaignরিসোর্সকে অবশ্যইsegments.date-এর (অন্য একটি ফিল্ড বেছে নেওয়া হচ্ছে) সাথে মানানসই হতে হবে। তাই, আপনাকে অবশ্যইcampaignরিসোর্সের জন্যselectableWithঅ্যাট্রিবিউট চেক করতে হবে।segments.dateযদিcampaign-এরselectableWithতালিকায় থাকে, তাহলে কোয়েরিটি সঠিক।
আপনি যদি এমন কোনও রিসোর্স থেকে ফিল্ড বেছে নেন যা FROM ক্লজে নেই, তাহলে সেই
রিসোর্সের selectableWith তালিকায় আপনার SELECT ক্লজে উপস্থিত অন্যান্য সব বিভাগ ও রিসোর্স
অবশ্যই অন্তর্ভুক্ত করতে হবে।
মেটাডেটার বিবরণ
আপনি GoogleAdsFieldService ব্যবহার করে ক্যাটালগের জন্য অনুরোধ করতে পারেন (GetGoogleAdsField সহ রিসোর্সের নাম
অথবা SearchGoogleAdsFields সহ কোয়েরি করে)
এই GoogleAdsFieldCategory লেভেলে:
- রিসোর্স (
RESOURCE) - যেমন,
googleAdsFields/campaign। - রিসোর্স অ্যাট্রিবিউট (
ATTRIBUTE) - যেমন,
googleAdsFields/campaign.name। - সেগমেন্টেশন ফিল্ড (
SEGMENT) - যেমন,
googleAdsFields/segments.ad_network_type। - মেট্রিক (
METRIC) - যেমন,
googleAdsFields/metrics.clicks।