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

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

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

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

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

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

الطلب

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