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

تتيح لك "لغة طلبات البحث في إعلانات 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) أو الحقول الفرعية من نوع التعداد أو الحقول الفرعية لرسائل الأغلفة الأساسية فقط.