مرتب کردن و محدود کردن نتایج

«زبان پُرسمان Google Ads» به شما امکان می‌دهد ردیف‌های برگردانده‌شده در پاسخ‌های پُرسمان را بااستفاده از بندهای ORDER BY و LIMIT مرتب و محدود کنید.

نتایج سفارش

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

FieldName (ASC | DESC)?

اگر ASC یا DESC را بعداز نام فیلد مشخص نکنید، Google Ads API به‌طور پیش‌فرض از ASC استفاده می‌کند. اگر عبارت ORDER BY را کاملاً حذف کنید، ترتیب ردیف‌های برگردانده‌شده غیرقطعی خواهد بود.

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

ORDER BY metrics.impressions DESC, campaign.name ASC

• براساس مشخصه‌های منابع انتخاب‌نشده
• براساس سنجه‌های انتخاب‌نشده
• براساس بخش‌های انتخاب‌نشده
• برای فیلدهای انواع زیر:
  • MESSAGE
  • فیلدهای تکراری
  • مشخصه‌های فیلدهای تکراری

محدود کردن تعداد نتایج

می‌توانید تعداد کل نتایج برگردانده‌شده را بااستفاده از عبارت LIMIT با عدد صحیح مثبت (1 یا بیشتر؛ LIMIT 0 معتبر نیست) محدود کنید. با ترکیب این مورد با ترتیب نتایج، می‌توانید گزارش‌های «N برتر» تولید کنید، مثلاً گزارشی حاوی پنج پویش با بالاترین تعداد ظهور در ۳۰ روز گذشته:

SELECT
  campaign.id,
  campaign.name,
  metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
ORDER BY metrics.impressions DESC
LIMIT 5

فیلتر کردن نتایج

هنگام ترکیب WHERE فیلتر با ORDER BY و LIMIT، محدودیت‌های فیلتر کردن زیر را درنظر داشته باشید:

• فیلتر کردن بخش‌ها بدون انتخاب آن‌ها مجاز نیست، به‌جز فیلدهای بخش تاریخ «اصلی» (segments.date، segments.week، segments.month، segments.quarter، و segments.year).
• فیلتر کردن مستقیماً در فیلدهای مرکب MESSAGE مجاز نیست (به‌جز پیام‌های پوشاننده اولیه مانند Int64Value و StringValue)؛ به‌جای آن، روی زیرفیلدهای اسکالر اولیه (int64، string، bool) یا شمارشی فیلتر کنید.
• فیلتر کردن در مشخصه‌های MESSAGE ترکیبی فیلدهای تکراری مجاز نیست؛ فقط فیلدهای فرعی پوشاننده اولیه، enum، یا اسکالر اولیه (int64، string، bool) را می‌توان فیلتر کرد.