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

«زبان پُرسمان 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) یا زیرفیلدهای enum فیلتر کنید.
• فیلتر کردن در مشخصه‌های MESSAGE ترکیبی فیلدهای تکراری مجاز نیست؛ فقط زیرفیلدهای اسکالر اولیه (int64، string، bool)، enum، یا پوشاننده اولیه را می‌توان فیلتر کرد.