Sắp xếp theo thứ tự và giới hạn kết quả

Ngôn ngữ truy vấn Google Ads cho phép bạn sắp xếp và giới hạn các hàng được trả về trong phản hồi truy vấn bằng cách sử dụng mệnh đề ORDER BY và LIMIT.

Sắp xếp kết quả

Bạn có thể chỉ định thứ tự của các hàng trong phản hồi bằng mệnh đề ORDER BY, bao gồm một hoặc nhiều trình tự được phân tách bằng dấu phẩy của:

FieldName (ASC | DESC)?

Nếu bạn không chỉ định ASC hoặc DESC sau tên trường, thì Google Ads API sẽ mặc định là ASC. Nếu bạn bỏ qua hoàn toàn mệnh đề ORDER BY, thì thứ tự của các hàng được trả về sẽ không xác định.

Mệnh đề ORDER BY sau đây sắp xếp báo cáo cấp chiến dịch theo số lượt hiển thị giảm dần và tên chiến dịch tăng dần:

ORDER BY metrics.impressions DESC, campaign.name ASC
  • Theo thuộc tính của tài nguyên không được chọn
  • Theo chỉ số không được chọn
  • Phân đoạn không được chọn
  • Đối với các trường thuộc những loại sau:
    • MESSAGE
    • Các trường lặp lại
    • Thuộc tính của các trường lặp lại

Giới hạn số lượng kết quả

Bạn có thể giới hạn tổng số kết quả được trả về bằng cách sử dụng mệnh đề LIMIT với một số nguyên dương (1 trở lên; LIMIT 0 không hợp lệ). Khi kết hợp điều này với việc sắp xếp kết quả, bạn có thể tạo báo cáo "N hàng đầu", chẳng hạn như báo cáo chứa 5 chiến dịch có số lượt hiển thị cao nhất trong 30 ngày qua:

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

Lọc kết quả

Khi kết hợp bộ lọc WHERE với ORDER BY và LIMIT, hãy lưu ý các quy định hạn chế sau đây về việc lọc:

  • Bạn không được phép lọc các phân đoạn mà không chọn chúng, ngoại trừ các trường phân đoạn ngày "cốt lõi" (segments.date, segments.week, segments.month, segments.quarter và segments.year).
  • Bạn không được phép lọc trực tiếp trên các trường MESSAGE phức hợp (ngoại trừ các thông báo trình bao bọc gốc như Int64Value và StringValue); thay vào đó, hãy lọc trên các trường con vô hướng gốc (int64, string, bool) hoặc enum.
  • Bạn không được phép lọc theo các thuộc tính MESSAGE tổng hợp của các trường lặp lại; bạn chỉ có thể lọc theo các trường con vô hướng gốc (int64, string, bool), enum hoặc trình bao bọc gốc.