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

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