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

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

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

يتألف الطلب من HTTP GET إلى خادم Reporting API في "إعلانات شبكة البحث 360" على عنوان 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"
  )