আপনি GoogleAdsFieldService
ব্যবহার করতে পারেন যা GoogleAdsService
অনুসন্ধান এবং অনুসন্ধান স্ট্রীম পদ্ধতিতে উপলব্ধ সম্পদ, সম্পদের ক্ষেত্র, সেগমেন্টেশন কী এবং মেট্রিক্সের জন্য ক্যাটালগকে গতিশীলভাবে অনুরোধ করতে পারেন। ক্যাটালগ মেটাডেটা প্রদান করে যা Google Ads API ক্লায়েন্টরা Google Ads Query Language স্টেটমেন্টের যাচাইকরণ এবং নির্মাণের জন্য ব্যবহার করতে পারে।
নমুনা HTTP অনুরোধ এবং প্রতিক্রিয়া
অনুরোধে নিম্নলিখিত URL-এ Google Ads API সার্ভারে একটি HTTP GET
রয়েছে:
https://googleads.googleapis.com/v17/googleAdsFields/{resource_or_field}
GoogleAdsFieldService
থেকে ad_group রিসোর্সের জন্য প্রত্যাবর্তিত প্রতিক্রিয়া অনুসরণ করে একটি অনুরোধের উদাহরণ নিচে দেওয়া হল:
অনুরোধ
https://googleads.googleapis.com/v17/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
।