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 số 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 cách sử dụng mệnh đề ORDER BY. Mệnh đề này bao gồm một hoặc nhiều chuỗi được phân tách bằng dấu phẩy:

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 các tài nguyên không được chọn
  • Theo các chỉ số không được chọn
  • Theo các phân khúc không được chọn
  • Đối với các trường thuộc các 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 mệnh đề này với việc sắp xếp kết quả, bạn có thể tạo báo cáo "N kết quả 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 hạn chế về việc lọc sau:

  • Bạn không được lọc trên các phân khúc mà không chọn các phân khúc đó, ngoại trừ các trường phân khúc ngày "cốt lõi" (segments.date, segments.week, segments.month, segments.quarter và segments.year).
  • Bạn không được lọc trực tiếp trên các trường MESSAGE tổng hợp (ngoại trừ các thông báo trình bao bọc nguyên thuỷ như Int64Value và StringValue); thay vào đó, hãy lọc trên các trường con vô hướng nguyên thuỷ (int64, string, bool) hoặc enum.
  • Bạn không được lọc trên 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 các trường con vô hướng nguyên thuỷ (int64, string, bool), enum hoặc trình bao bọc nguyên thuỷ.