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

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

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

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

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

يعرض المثال التالي طلبًا متبوعًا بالردّ الذي تم تلقّيه من GoogleAdsFieldService لمورد ad_group:

طلب

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