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

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

FieldName ('ASC' | 'DESC')?

إذا لم تحدّد ASC أو DESC بعد اسم حقل، ستستخدم Google Ads API بشكلٍ تلقائي القيمة ASC.

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

ORDER BY metrics.impressions DESC, campaign.name ASC

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

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

يمكنك الحدّ من إجمالي عدد النتائج المعروضة باستخدام عبارة LIMIT. من خلال الجمع بين هذه العبارة وترتيب النتائج، يمكنك إنشاء تقارير "أفضل 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

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