تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

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

يوضّح المثال التالي طلبًا متبوعًا بالردّ الذي تم عرضه من GoogleAdsFieldService لمورد ad_group:

طلب

https://googleads.googleapis.com/v26/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 بدون تقسيم المقاييس تتم تعبئة هذا الحقل فقط للحقول التي تكون فيها قيمة category هي RESOURCE.
metrics: المقاييس التي يمكن اختيارها مع المورد في عبارة FROM. تتم تعبئة هذا الحقل فقط للحقول التي تكون فيها قيمة category هي RESOURCE.
segments: مفاتيح التقسيم (حقول segments.* وموارد التقسيم) التي يمكن اختيارها مع المورد في عبارة FROM. وتقسّم هذه المقاييس المحدّدة في طلب البحث. تتم تعبئة هذا الحقل فقط للحقول التي تكون فيها قيمة category هي RESOURCE.
selectableWith: الموارد أو الشرائح أو المقاييس التي يمكن اختيارها في طلب البحث نفسه بلغة طلب البحث في "إعلانات Google" عندما لا يكون هذا المورد أو هذه الشريحة المورد الأساسي في عبارة FROM.

التحقّق من التوافق مع selectableWith

تحدّد السمة selectableWith في حقل مورد أو شريحة الموارد أو الشرائح أو المقاييس الأخرى التي يمكن اختيارها في طلب البحث نفسه بلغة طلب البحث في "إعلانات Google". تكون هذه السمة مهمة عندما تريد تضمين حقول من مورد أو قسم غير محدّد في عبارة FROM.

عند إنشاء طلب بحث بلغة طلب البحث في "إعلانات Google":

المورد في عبارة FROM هو الكيان الأساسي. يمكنك دائمًا اختيار حقول من هذا المورد.
يمكنك أيضًا اختيار المقاييس والشرائح المتوافقة والمتوفّرة مع الكيان الأساسي.
إذا أدرجت حقولاً من أي مورد أو قسم خارج عبارة FROM، عليك التأكّد من أنّ هذا المورد أو القسم غير التابع لـ FROM متوافق مع جميع الحقول والأقسام والمقاييس الأخرى التي تم اختيارها في طلب البحث.

تحتوي قائمة selectableWith لمورد معيّن (المورد "أ") على جميع الموارد والشرائح والمقاييس الأخرى التي يمكن اختيارها مع حقول من المورد "أ" عندما لا يكون المورد "أ" هو الكيان الأساسي.

مثال

لنفترض أنّ طلب البحث هو:

SELECT ad_group.id, segments.date, campaign.name FROM ad_group

تحدّد عبارة FROM السمة ad_group.
يختار طلب البحث هذا ad_group.id (من المورد FROM) وsegments.date وcampaign.name.
بما أنّه تم اختيار campaign.name، ولكن لم يتم تضمين campaign في عبارة FROM، عليك التحقّق من توافقه مع العناصر الأخرى المحدّدة.
لضمان صلاحية طلب البحث هذا، يجب أن يكون المورد campaign متوافقًا مع segments.date (حقل آخر يتم اختياره). لذلك، عليك التحقّق من السمة selectableWith لمورد campaign. إذا كان segments.date موجودًا في قائمة selectableWith الخاصة بـ campaign، يكون طلب البحث صالحًا.

إذا اخترت حقولاً من مورد غير مضمّن في عبارة FROM، يجب أن تتضمّن قائمة selectableWith الخاصة بهذا المورد جميع الشرائح والموارد الأخرى الموجودة في عبارة SELECT.

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

يمكنك طلب الكتالوج باستخدام GoogleAdsFieldService (إما من خلال اسم المورد مع GetGoogleAdsField أو من خلال طلب البحث باستخدام SearchGoogleAdsFields) على مستويات GoogleAdsFieldCategory هذه:

المورد (RESOURCE): على سبيل المثال، googleAdsFields/campaign.
سمة المرجع (ATTRIBUTE): على سبيل المثال، googleAdsFields/campaign.name.
حقل التقسيم (SEGMENT): على سبيل المثال، googleAdsFields/segments.ad_network_type.
المقياس (METRIC): على سبيل المثال، googleAdsFields/metrics.clicks.

جارٍ استرداد العناصر

بنية المكالمة