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

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

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

অনুরোধে নিম্নলিখিত URL-এ অনুসন্ধান বিজ্ঞাপন 360 রিপোর্টিং API সার্ভারে একটি HTTP GET রয়েছে:

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

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

অনুরোধ

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

প্রতিক্রিয়া

{
  "resourceName": "searchAds360Fields/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 ক্ষেত্র।

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

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

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

ক্ষেত্রের বিবরণ পেতে একটি প্রশ্ন ব্যবহার করুন

এটি একটি প্রশ্ন পাঠিয়ে ক্ষেত্রের বিবরণ পেতে সম্ভব

https://searchads360.googleapis.com/v0/searchAds360Fields:search

উদাহরণ 1: একটি রেগুলার এক্সপ্রেশন ব্যবহার করা।

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name LIKE 'ad_group.%'"

উদাহরণ 2: নির্দিষ্ট ক্ষেত্র, মেট্রিক্স বা বিভাগ জিজ্ঞাসা করা।

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE
  name IN (
    "ad_group.id",
    "ad_group.name",
    "segments.date",
    "customer.id",
    "customer.manager",
    "metrics.clicks"
  )
,

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

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

অনুরোধে নিম্নলিখিত URL-এ অনুসন্ধান বিজ্ঞাপন 360 রিপোর্টিং API সার্ভারে একটি HTTP GET রয়েছে:

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

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

অনুরোধ

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

প্রতিক্রিয়া

{
  "resourceName": "searchAds360Fields/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 ক্ষেত্র।

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

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

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

ক্ষেত্রের বিবরণ পেতে একটি প্রশ্ন ব্যবহার করুন

এটি একটি প্রশ্ন পাঠিয়ে ক্ষেত্রের বিবরণ পেতে সম্ভব

https://searchads360.googleapis.com/v0/searchAds360Fields:search

উদাহরণ 1: একটি রেগুলার এক্সপ্রেশন ব্যবহার করা।

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name LIKE 'ad_group.%'"

উদাহরণ 2: নির্দিষ্ট ক্ষেত্র, মেট্রিক্স বা বিভাগ জিজ্ঞাসা করা।

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE
  name IN (
    "ad_group.id",
    "ad_group.name",
    "segments.date",
    "customer.id",
    "customer.manager",
    "metrics.clicks"
  )