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

GoogleAdsFieldService ব্যবহার করে আপনি GoogleAdsService Search ও SearchStream মেথডে উপলভ্য রিসোর্সের ক্যাটালগ, রিসোর্স ফিল্ড, সেগমেন্টেশন কী ও মেট্রিক ডায়নামিক অনুরোধ করতে পারেন (GetGoogleAdsField বা SearchGoogleAdsFields-এর মাধ্যমে)। ক্যাটালগ এমন মেটাডেটা প্রদান করে যা Google Ads কোয়েরি ল্যাঙ্গুয়েজ স্টেটমেন্টের যাচাইকরণ ও কনস্ট্রাকশনের জন্য Google Ads API ক্লায়েন্ট ব্যবহার করতে পারে।

HTTP অনুরোধ ও উত্তরের নমুনা

অনুরোধে নিম্নলিখিত URL-এ Google Ads API সার্ভারে একটি HTTP GET থাকে:

https://googleads.googleapis.com/v25/googleAdsFields/{resource_or_field}

নিচে দেওয়া উদাহরণে ad_group রিসোর্সের জন্য GoogleAdsFieldService থেকে পাওয়া উত্তরের সাথে অনুরোধ দেখানো হয়েছে:

অনুরোধ করুন

https://googleads.googleapis.com/v25/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 ক্লজে প্রাথমিক রিসোর্স নয়।

selectWith-এর সাথে কোয়েরির কম্প্যাটিবিলিটি

কোনও রিসোর্স বা সেগমেন্ট ফিল্ডের selectableWith অ্যাট্রিবিউট অন্যান্য রিসোর্স, সেগমেন্ট বা মেট্রিক নির্দিষ্ট করে যা একই Google Ads কোয়েরি ল্যাঙ্গুয়েজ কোয়েরিতে বেছে নেওয়া যেতে পারে। FROM ক্লজে উল্লেখ করা নেই এমন কোনও রিসোর্স বা সেগমেন্ট থেকে ফিল্ড অন্তর্ভুক্ত করতে চাইলে এই অ্যাট্রিবিউটটি গুরুত্বপূর্ণ।

Google Ads কোয়েরি ল্যাঙ্গুয়েজ কোয়েরি তৈরি করার সময়:

  1. FROM ক্লজের রিসোর্স হল প্রাথমিক এন্টিটি। আপনি সবসময় এই রিসোর্স থেকে ফিল্ড বেছে নিতে পারবেন।
  2. এছাড়াও, আপনি প্রাথমিক এন্টিটির সাথে উপলভ্য মানানসই মেট্রিক ও সেগমেন্ট বেছে নিতে পারবেন।
  3. FROM ধারা ছাড়া অন্য কোনও রিসোর্স বা সেগমেন্ট থেকে ফিল্ড যোগ করলে, আপনাকে অবশ্যই নিশ্চিত করতে হবে যে এই নন-FROM রিসোর্স বা সেগমেন্টটি কোয়েরিতে বেছে নেওয়া অন্যান্য ফিল্ড, সেগমেন্ট ও মেট্রিকের সাথে মানানসই।

নির্দিষ্ট রিসোর্সের (রিসোর্স ক) জন্য selectableWith তালিকায় অন্যান্য সব রিসোর্স, সেগমেন্ট ও মেট্রিক থাকে যা রিসোর্স ক-এর ফিল্ডের সাথে বেছে নেওয়া যায় যখন রিসোর্স ক হল না প্রাথমিক এন্টিটি।

উদাহরণ

এই কোয়েরির উদাহরণটি দেখুন:

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 অ্যাট্রিবিউট চেক করতে হবে। campaign-এর selectableWith তালিকায় segments.date থাকলে, কোয়েরিটি সঠিক।

আপনি যদি FROM ধারায় নেই এমন কোনও রিসোর্স থেকে ফিল্ড বেছে নেন, তাহলে সেই রিসোর্সের selectableWith তালিকায় আপনার SELECT ধারায় উপস্থিত থাকা অন্যান্য সব বিভাগ ও রিসোর্স থাকতে হবে।

মেটাডেটার বিবরণ

আপনি GoogleAdsFieldService ব্যবহার করে ক্যাটালগের জন্য অনুরোধ করতে পারেন (GetGoogleAdsField সহ রিসোর্স নামের মাধ্যমে অথবা SearchGoogleAdsFields সহ কোয়েরি করার মাধ্যমে) এই GoogleAdsFieldCategory লেভেলে:

রিসোর্স (RESOURCE)
যেমন, googleAdsFields/campaign।
রিসোর্স অ্যাট্রিবিউট (ATTRIBUTE)
যেমন, googleAdsFields/campaign.name।
সেগমেন্টেশন ফিল্ড (SEGMENT)
যেমন, googleAdsFields/segments.ad_network_type।
মেট্রিক (METRIC)
যেমন, googleAdsFields/metrics.clicks।
পূর্ববর্তী
অবজেক্ট ফিরিয়ে আনা
পরবর্তী
কল স্ট্রাকচার