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

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

يمكنك تحديد ترتيب الصفوف في ردك باستخدام عبارة 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 وما إلى ذلك)