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

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

নমুনা HTTP অনুরোধ এবং প্রতিক্রিয়া

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

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

নিম্নলিখিত উদাহরণে ad_group রিসোর্সের জন্য GoogleAdsFieldService থেকে ফিরে আসা একটি অনুরোধের পরে প্রতিক্রিয়া দেখানো হয়েছে:

অনুরোধ 

https://googleads.googleapis.com/v22/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 থেকে ফিল্ডের পাশাপাশি নির্বাচন করা যেতে পারে যখন রিসোর্স 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 ব্যবহার করে ক্যাটালগের জন্য অনুরোধ করতে পারেন:

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