ترتيب النتائج وتقييد النتائج

تتيح لك "لغة طلبات البحث في إعلانات Google" ترتيب الصفوف المعروضة في ردود طلبات البحث وتحديد عددها الأقصى باستخدام عبارتَي ORDER BY وLIMIT.

ترتيب النتائج

يمكنك تحديد ترتيب الصفوف في ردّك باستخدام عبارة ORDER BY، التي تتألف من تسلسل واحد أو أكثر من التسلسلات المفصولة بفواصل:

FieldName (ASC | DESC)?

إذا لم تحدّد ASC أو DESC بعد اسم حقل، ستستخدِم Google Ads API القيمة التلقائية ASC. إذا حذفت عبارة ORDER BY بالكامل، سيكون ترتيب الصفوف التي يتم عرضها غير محدّد.

ترتّب عبارة ORDER BY التالية تقريرًا على مستوى الحملة حسب عدد مرّات الظهور تنازليًا واسم الحملة تصاعديًا:

ORDER BY metrics.impressions DESC, campaign.name ASC

ملاحظة: لا يُسمح بالطلب في الحالات التالية:

• حسب سمات الموارد غير المحدّدة
• حسب المقاييس غير المحدّدة
• حسب الشرائح غير المحدّدة
• بالنسبة إلى الحقول من الأنواع التالية:
  • MESSAGE
  • الحقول المتكررة
  • سمات الحقول المتكرّرة

وضع حدّ أقصى لعدد النتائج

يمكنك الحدّ من إجمالي عدد النتائج التي يتم عرضها باستخدام عبارة LIMIT مع عدد صحيح موجب (1 أو أكبر، LIMIT 0 غير صالح). ومن خلال الجمع بين ذلك وترتيب النتائج، يمكنك إنشاء تقارير "أفضل N"، مثل تقرير يتضمّن الحملات الخمس التي حقّقت أعلى عدد من مرّات الظهور خلال آخر 30 يومًا:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

فلترة النتائج

عند الجمع بين فلاتر WHERE وORDER BY وLIMIT، يجب مراعاة قيود الفلترة التالية:

• لا يُسمح بالفلترة في الشرائح بدون تحديدها، باستثناء حقول شريحة التاريخ "الأساسية" (segments.date وsegments.week وsegments.month وsegments.quarter وsegments.year).
• لا يُسمح بالفلترة في حقول MESSAGE المركّبة مباشرةً (باستثناء رسائل الأغلفة الأساسية مثل Int64Value وStringValue)، بل يجب الفلترة في الحقول الفرعية الأساسية العددية (int64 وstring وbool) أو الحقول الفرعية الخاصة بالتعداد.
• لا يُسمح بالفلترة حسب سمات MESSAGE المركّبة للحقول المتكرّرة، بل يمكن الفلترة حسب الحقول الفرعية البدائية العددية (int64 أو string أو bool) أو التعداد أو الحقول الفرعية البدائية التي تتضمّن برنامج تضمين.