لغة طلب البحث في "إعلانات شبكة البحث 360"

تتيح لك لغة طلبات البحث في "إعلانات شبكة البحث 360" إنشاء طلبات بحث لاسترداد بيانات إعداد التقارير والبيانات الوصفية للموارد باستخدام Search Ads 360 Reporting API.

البحث في الخدمات

يمكنك استخدام لغة طلب البحث في "إعلانات شبكة البحث 360" لإجراء طلبات بحث في واجهة برمجة التطبيقات باستخدام:

SearchAds360Service

استخدم هذه الخدمة للاستعلام عن الموارد والسمات والشرائح والمقاييس ذات الصلة. هناك طريقتان، Search وSearchStream.

تعرض SearchAds360Service طلبات بحث قائمة بمثيلات SearchAds360Row:

  • يمثل كل صف موردًا.
  • تتضمّن الصفوف حقول السمات والمقاييس، إذا طُلب منك ذلك.
  • إذا طلبت الأقسام، يتم تضمين صفوف إضافية لكل صف من صفوف موارد الشريحة.

راجِع إنشاء تقارير البحث للحصول على مزيد من المعلومات.

SearchAds360FieldService

يمكنك استخدام هذه الخدمة للبحث عن بيانات وصفية عن الحقول والموارد المتاحة. توفر الخدمة كتالوجًا من الحقول التي يمكن الاستعلام عنها مع تفاصيل حول توافقها ونوعها.

تعرض SearchAds360FieldService قائمة من SearchAds360Field من المثيلات:

  • يحتوي كل حقل على تفاصيل عن الحقل المطلوب.

يُرجى الاطِّلاع على استرداد البيانات الوصفية للموارد لمزيد من المعلومات.

أمثلة طلبات البحث الأساسية

تقدم الأقسام التالية أمثلة على طلبات بحث أساسية يمكنك تعديلها لإنشاء استعلاماتك الخاصة.

طلب بحث عن سمات مورد

هذا استعلام أساسي لسمات مورد campaign الذي يعرض رقم تعريف الحملة واسمها والحالة:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • ويمثّل كل عرض SearchAds360Row كائن campaign.
  • تتم تعبئة الصفوف بالحقول المحدّدة (بما في ذلك resource_name للحملة المحدّدة).
  • طلبات البحث حسب رقم تعريف الحملة.

راجِع campaign للاطّلاع على الحقول الأخرى المتاحة التي يمكنك استخدامها في طلبات البحث.

طلب بحث عن المقاييس

هذا طلب بحث أساسي للمقاييس المرتبطة بسمات مورد campaign:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id
  • يعرض طلب البحث الحملات بالحالة PAUSED وأكثر من 1,000 مرة ظهور.
  • يحتوي كل SearchAds360Row يتم عرضه على حقل metrics تمت تعبئته بالمقاييس التي تم اختيارها.
  • طلبات البحث حسب رقم تعريف الحملة.

راجِع metrics للاطّلاع على المقاييس الأخرى المتاحة التي يمكنك استخدامها في طلبات البحث.

طلب بحث عن الشرائح

هذا استعلام أساسي للمقاطع المرتبطة بسمات مورد campaign:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
  • يعرض طلب البحث الحملات بالحالة PAUSED وأكثر من 1,000 مرة ظهور.
  • يعمل على تقسيم البيانات حسب التاريخ.
  • كنتيجة للتقسيم، تمثِّل كل قيمة SearchAds360Row صفًا من الحملة وشريحة التاريخ.
  • طلبات البحث حسب رقم تعريف الحملة.

راجِع segments للحصول على قائمة بالشرائح التي يمكنك استخدامها في طلبات البحث والتصنيف للحصول على مزيد من المعلومات عن تقسيم تقاريرك.

هذا استعلام أساسي على مورد campaign الذي يضم سمات مورد bidding_strategy، إذا كان ذلك متاحًا. يُعرف هذا النوع من الموارد ذات الصلة باسم المورد المنسوبة.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • يحدد طلب البحث سمات الحملة والسمات ذات الصلة من كل حملة محددة.
  • يمثّل كل عرض SearchAds360Row عنصر campaign تمت تعبئته بسمات الحملة المحدّدة، بالإضافة إلى سمة استراتيجية عروض الأسعار المحدّدة، bidding_strategy.name.

اطّلِع على campaign لمعرفة الموارد التي تتوفّر لها بيانات الحملة والمتاحة لطلبات البحث الخاصة بالحملة.

طلب بحث عن البيانات الوصفية للحقل

يمكنك استخدام SearchAds360FieldService لاسترداد البيانات الوصفية للحقل.

هذا استعلام أساسي لبيانات التعريف للحقل:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • استبدِل المورد أو الحقل بمورد (مثل customer أو campaign) أو بحقل (مثل campaign.id أو metrics.impressions أو ad_group.id).

راجع استرداد البيانات الوصفية للموارد لمزيد من المعلومات حول استرداد البيانات الوصفية للحقل.

مزيد من المعلومات

اطّلِع على مزيد من المعلومات عن كيفية إنشاء طلبات البحث في Search Ads 360 Reporting API: