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

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

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

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

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

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

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

طلب

https://googleads.googleapis.com/v25/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

تحدّد السمة selectableWith في حقل مصدر أو شريحة مصادر أو شرائح أو مقاييس أخرى يمكن اختيارها في طلب بحث GAQL نفسه. تكون هذه السمة ضرورية عندما تريد تضمين حقول من مصدر أو جزء لم يتم تحديدهما في عبارة FROM.

عند إنشاء طلب بحث GAQL، يجب مراعاة ما يلي:

المورد في عبارة 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 على المستويات التالية:

المورد: على سبيل المثال، googleAdsFields/campaign.
حقل المرجع: على سبيل المثال، googleAdsFields/campaign.name.
حقل التقسيم: على سبيل المثال، googleAdsFields/segments.ad_network_type.
المقياس: على سبيل المثال، googleAdsFields/metrics.clicks.

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

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

البيانات الوصفية للموارد تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

طلب

الردّ

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

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