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

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

FieldName ('ASC' | 'DESC')?

في حال عدم تحديد ASC أو DESC بعد اسم حقل، سيتم تلقائيًا استخدام ASC في Google Ads API.

ترتّب عبارة 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