يمكنك استخدام GoogleAdsFieldService
لطلب كتالوج الموارد وحقول الموارد ومفاتيح
التصنيف إلى شرائح ومقاييس المتاحة بشكل ديناميكي من خلال طريقتَي GoogleAdsService
البحث وSearchStream. ويوفر الكتالوج بيانات وصفية يمكن استخدامها بواسطة برامج Google Ads API للتحقّق من صحة عبارات "لغة طلب البحث" في "إعلانات Google" وإنشاء هذه العبارات.
نموذج طلب واستجابة HTTP
يتألف الطلب من HTTP GET
إلى خادم Google Ads API على عنوان URL التالي:
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.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
.