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

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

مثال على طلب HTTP واستجابته

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

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

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

الطلب

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