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

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

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

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

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

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

অনুরোধ

https://googleads.googleapis.com/v16/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
যে ক্ষেত্রগুলি একটি প্রদত্ত ক্ষেত্রের পাশাপাশি নির্বাচন করা যেতে পারে, যখন FROM ক্লজে না থাকে৷ এই বৈশিষ্ট্যটি শুধুমাত্র প্রাসঙ্গিক যখন সম্পদ বা সেগমেন্টগুলি সনাক্ত করা যায় যেগুলি একটি প্রশ্নে নির্বাচন করা যেতে পারে যেখানে সেগুলি FROM ক্লজে সংস্থান দ্বারা অন্তর্ভুক্ত নয়৷ উদাহরণ স্বরূপ, যদি আমরা ad_group থেকে ad_group.id এবং segments.date নির্বাচন করি এবং আমরা campaign বৈশিষ্ট্যগুলি অন্তর্ভুক্ত করতে চাই, তাহলে আমাদের চেক করতে হবে যে segments.date প্রচারাভিযানের জন্য selectableWith অ্যাট্রিবিউটে রয়েছে, যেহেতু এটি নির্বাচন করা হচ্ছে বিদ্যমান segments.date ক্ষেত্র।

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

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

সম্পদ
উদাহরণস্বরূপ, googleAdsFields/campaign
সম্পদের ক্ষেত্র
উদাহরণস্বরূপ, googleAdsFields/campaign.name
বিভাজন ক্ষেত্র
উদাহরণস্বরূপ, googleAdsFields/segments.ad_network_type
মেট্রিক
উদাহরণস্বরূপ, googleAdsFields/metrics.clicks