يمكنك استخدام GoogleAdsFieldService
لطلب الكتالوج ديناميكيًا للمراجع وحقول المراجع ومفاتيح التحليل
والمقاييس المتاحة في الطريقتَين GoogleAdsService
Search وSearchStream. يقدّم الكتالوج بيانات وصفية يمكن
لعملاء Google Ads API استخدامها للتحقّق من صحة عبارات لغة طلبات البحث في "إعلانات Google" وإنشاءها.
مثال على طلب HTTP واستجابته
يتألّف الطلب من HTTP GET
إلى خادم Google Ads API على العنوان التالي
URL:
https://googleads.googleapis.com/v19/googleAdsFields/{resource_or_field}
في ما يلي مثال على طلب متبوعًا بالاستجابة التي تم عرضها من
GoogleAdsFieldService
لمورد ad_group:
الطلب
https://googleads.googleapis.com/v19/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.id
وsegments.date
منad_group
، وأردنا تضمين سمات منcampaign
، علينا التأكّد من أنّsegments.date
متوفّرة في سمةselectableWith
للحملة، لأنّه يتم اختيارها إلى جانب الحقل الحاليsegments.date
.
تفاصيل البيانات الوصفية
يمكنك طلب الكتالوج باستخدام GoogleAdsFieldService
على المستويَين التاليَين:
- المورد
- على سبيل المثال،
googleAdsFields/campaign
. - حقل المرجع
- على سبيل المثال،
googleAdsFields/campaign.name
. - حقل التقسيم
- على سبيل المثال،
googleAdsFields/segments.ad_network_type
. - المقياس
- على سبيل المثال،
googleAdsFields/metrics.clicks
.