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

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

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

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

https://searchads360.googleapis.com/v0/searchAds360Fields/{resource_or_field}

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

الطلب

https://searchads360.googleapis.com/v0/searchAds360Fields/ad_group

الرد

{
  "resourceName": "searchAds360Fields/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 الحالي.

تفاصيل البيانات الوصفية

يمكنك طلب القائمة باستخدام "SearchAds360FieldService" على المستويات التالية:

المورد

على سبيل المثال، searchAds360Fields/campaign.

حقل المرجع

على سبيل المثال، searchAds360Fields/campaign.name.

حقل التقسيم

على سبيل المثال، searchAds360Fields/segments.ad_network_type.

المقياس

على سبيل المثال، searchAds360Fields/metrics.clicks.

استخدِم طلب بحث للحصول على تفاصيل الحقول

من الممكن الحصول على تفاصيل الحقل من خلال إرسال طلب بحث إلى

https://searchads360.googleapis.com/v0/searchAds360Fields:search

المثال 1: استخدام تعبير عادي

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name LIKE 'ad_group.%'"

المثال 2: طلب البحث عن حقول أو مقاييس أو شرائح معيّنة

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE
  name IN (
    "ad_group.id",
    "ad_group.name",
    "segments.date",
    "customer.id",
    "customer.manager",
    "metrics.clicks"
  )