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

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

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

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

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

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

طلب

https://googleads.googleapis.com/v20/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.
السابق
جارٍ استرداد العناصر
التالي
بنية المكالمة