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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

يمكنك استخدام 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.