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

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