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