نتایج سفارش

شما می‌توانید ترتیب ردیف‌ها را در پاسخ خود با استفاده از دستور ORDER BY مشخص کنید، که شامل یک یا چند توالی جدا شده با کاما از موارد زیر است:

FieldName ('ASC' | 'DESC')?

اگر بعد از نام فیلد ASC یا DESC را مشخص نکنید، API تبلیغات گوگل به طور پیش‌فرض ASC را در نظر می‌گیرد.

دستور ORDER BY زیر، گزارش سطح کمپین را بر اساس تعداد نمایش (impress) به صورت نزولی و نام کمپین به صورت صعودی مرتب می‌کند:

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.