سفارش و محدود کردن نتایج

نتایج سفارش

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

FieldName ('ASC' | 'DESC')?

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

بند 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، و غیره)