রিসোর্স মেটাডেটা

আপনি 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 কোয়েরি ল্যাঙ্গুয়েজ কোয়েরি তৈরি করার সময়:

  1. FROM ক্লজে রিসোর্স হল প্রাথমিক এন্টিটি। আপনি সবসময় এই রিসোর্স থেকে ফিল্ড বেছে নিতে পারবেন।
  2. এছাড়াও, আপনি প্রাইমারি এন্টিটির সাথে উপলভ্য মানানসই মেট্রিক ও সেগমেন্ট বেছে নিতে পারবেন।
  3. আপনি যদি 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 বেছে নেওয়া হয়েছে, কিন্তু campaign FROM ক্লজে নেই, আপনাকে অবশ্যই অন্যান্য বেছে নেওয়া এলিমেন্টের সাথে এর কম্প্যাটিবিলিটি যাচাই করতে হবে।
  • এই কোয়েরি সঠিক কিনা তা নিশ্চিত করতে, 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।