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

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