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

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