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

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

নমুনা 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 ক্লজের রিসোর্সের সাথে যে রিসোর্সগুলোকে পরোক্ষভাবে যুক্ত করা যায়।
metrics
FROM ক্লজে রিসোর্সের সাথে যে মেট্রিকগুলো নির্বাচন করা যায়। শুধুমাত্র সেইসব ফিল্ডের জন্য এটি পূরণ করা হয়, যেগুলোর category হলো RESOURCE ।
segments
সেগমেন্ট কী যা FROM ক্লজে রিসোর্সের সাথে নির্বাচন করা যায়। এগুলো কোয়েরিতে নির্দিষ্ট করা মেট্রিকগুলোকে সেগমেন্ট করে। শুধুমাত্র সেইসব ফিল্ডের জন্য পূরণ করা হয় যেখানে category হলো RESOURCE ।
selectableWith

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

GAQL কোয়েরি তৈরি করার সময়:

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

একটি নির্দিষ্ট রিসোর্সের (ধরা যাক রিসোর্স A) জন্য selectableWith তালিকায় অন্য সব রিসোর্স, সেগমেন্ট এবং মেট্রিক অন্তর্ভুক্ত থাকে, যেগুলো রিসোর্স 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 অ্যাট্রিবিউটটি পরীক্ষা করতে হবে। যদি campaign এর selectableWith তালিকায় segments.date উপস্থিত থাকে, তাহলে কোয়েরিটি বৈধ।

যদি আপনি এমন কোনো রিসোর্স থেকে ফিল্ড নির্বাচন করেন যা FROM ক্লজে নেই, তাহলে সেই রিসোর্সের selectableWith তালিকায় আপনার SELECT ক্লজে উপস্থিত অন্য সব সেগমেন্ট এবং রিসোর্স অবশ্যই অন্তর্ভুক্ত থাকতে হবে।

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

আপনি GoogleAdsFieldService ব্যবহার করে এই স্তরগুলিতে ক্যাটালগের জন্য অনুরোধ করতে পারেন:

সম্পদ
উদাহরণস্বরূপ, googleAdsFields/campaign ।
সম্পদের ক্ষেত্র
উদাহরণস্বরূপ, googleAdsFields/campaign.name .
বিভাজন ক্ষেত্র
উদাহরণস্বরূপ, googleAdsFields/segments.ad_network_type ।
মেট্রিক
উদাহরণস্বরূপ, googleAdsFields/metrics.clicks ।
পূর্ববর্তী
বস্তু পুনরুদ্ধার করা হচ্ছে
পরবর্তী
কল গঠন