ترتيب النتائج وتحديدها

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

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

FieldName ('ASC' | 'DESC')?

إذا لم تحدّد ASC أو DESC بعد اسم الحقل، سيتم ضبط Google Ads API تلقائيًا على ASC.

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

ORDER BY metrics.impressions DESC, campaign.name ASC

غير مسموح بالطلب:

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

الحد من عدد النتائج

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

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

الفلترة غير مسموح بها:

  • على الشرائح بدون اختيارها، باستثناء حقول شرائح التاريخ "الأساسية".
    • حقول شريحة التاريخ الأساسية هي segments.date وsegments.week وsegments.month وsegments.quarter وsegments.year.
  • في الحقول من أي نوع من أنواع الرسائل باستثناء الرسائل الأساسية (مثال: Int64Value وStringValue وما إلى ذلك).
  • في سمات الحقول المتكرّرة من أي نوع رسالة باستثناء القيم الأساسية (مثال: Int64Value وStringValue وما إلى ذلك).