البيانات الوصفية للموارد

يمكنك استخدام GoogleAdsFieldService لطلب الكتالوج ديناميكيًا للموارد وحقول المورد ومفاتيح التصنيف والمقاييس المتاحة في الطريقتين GoogleAdsService بحث وSearchStream. يوفر الكتالوج بيانات وصفية يمكن استخدامها من جانب عملاء إعلانات Google API للتحقق من صحة عبارات عبارات البحث بلغة إعلانات Google وإنشاؤها.

نموذج لطلب HTTP والرد

يتألف الطلب من HTTP GET إلى خادم إعلانات Google API على عنوان URL التالي:

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

في ما يلي مثال لطلب متبوع باستجابة من GoogleAdsFieldService لمورد ad_group:

طلب

https://googleads.googleapis.com/v13/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.