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

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

نموذج لطلب HTTP واستجابةه

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

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

في ما يلي مثال على طلب متبوعًا بردّ من GoogleAdsFieldService لمورد ad_group:

الطلب

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