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

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

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

FieldName ('ASC' | 'DESC')?

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

يرتّب القسم 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 وما إلى ذلك)