Cấu trúc truy vấn

Bạn có thể gửi truy vấn về các trường chỉ số và phân đoạn đến reports.search . Để tạo truy vấn bằng Ngôn ngữ truy vấn Merchant Center, trước tiên bạn cần soạn bằng cách sử dụng ngữ pháp ngôn ngữ. Truy vấn được tạo thành từ một số mệnh đề:

  • SELECT
  • FROM
  • WHERE
  • ORDER BY
  • LIMIT

Mệnh đề sử dụng tên trường, tên bảng, toán tử, điều kiện và thứ tự để giúp bạn chọn dữ liệu mong muốn. Sau khi được kết hợp thành một , bạn có thể đưa ra yêu cầu bằng cách sử dụng Google Content API for Shopping. Hãy cùng xem cách mỗi mệnh đề có thể được sử dụng.

Mệnh đề

SELECT

Mệnh đề SELECT chỉ định một tập hợp các trường cần tìm nạp trong yêu cầu. SELECT lấy danh sách các trường và chỉ số được phân tách bằng dấu phẩy, trả về các giá trị trong câu trả lời. Mệnh đề SELECT là bắt buộc trong truy vấn.

Dưới đây là truy vấn mẫu chọn các chỉ số lượt nhấp từ một bảng nhất định:

SELECT
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

Bạn cũng có thể truy vấn nhiều loại trường trong một yêu cầu:

SELECT
  segments.date,
  segments.program,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

  • Trường phân đoạn

    • segments.date
    • segments.program

  • Chỉ số

    • metrics.impressions
    • metrics.clicks

Một số trường không được phép trong mệnh đề SELECT do lý do sau hạn chế:

  • Truy vấn các trường phân đoạn mà không có ít nhất một trường chỉ số.

Thông tin liên quan đến tình trạng nêu trên có trong tài liệu tham khảo của chúng tôi.

FROM

Mệnh đề FROM chỉ định bảng để tìm nạp dữ liệu trong yêu cầu. Chiến lược phát hành đĩa đơn bảng trong mệnh đề FROM xác định trường nào có thể được sử dụng bởi tất cả các trường khác mệnh đề cho truy vấn cho trước. Bạn chỉ có thể chỉ định một bảng trong Mệnh đề FROM. Hiện tại, chúng tôi chỉ hỗ trợ bảng MerchantPerformanceView. Mệnh đề FROM là bắt buộc trong truy vấn tới phương thức search trên Dịch vụ reports.

Ở ĐÂU?

Mệnh đề WHERE chỉ định các điều kiện sẽ áp dụng khi lọc dữ liệu cho của bạn. Khi sử dụng mệnh đề WHERE, bạn có thể chỉ định một hoặc nhiều điều kiện bằng cách sử dụng AND để phân tách chúng. Mỗi điều kiện phải tuân theo mẫu field_name Operator value. Bạn có thể dùng trường phân đoạn bất kỳ trong WHERE nhưng các trường chỉ số cần được chỉ định trong mệnh đề SELECT để được được dùng trong mệnh đề WHERE. Mệnh đề WHERE là bắt buộc trong truy vấn, bởi vì bạn phải luôn chỉ định phạm vi ngày cho thời điểm bạn muốn dữ liệu hiệu suất được trả về.

Sau đây là ví dụ về cách sử dụng WHERE để trả về các chỉ số của một thời điểm nhất định khoảng thời gian:

SELECT
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

Bạn có thể kết hợp nhiều điều kiện để lọc dữ liệu. Ví dụ này sẽ trả về số lượt nhấp trên mỗi mặt hàng trong chương trình SHOPPING_ADS có lượt nhấp > 100 trong khoảng thời gian 30 ngày đã cho.

SELECT
  segments.offer_id,
  segments.program,
  metrics.clicks
FROM MerchantPerformanceView
WHERE metrics.clicks > 100
  AND segments.program = SHOPPING_ADS
  AND segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’;

Trong truy vấn sau, bạn sẽ thấy segments.date đã được chọn. Bất kể bạn chọn segments.date hay không, một phạm vi ngày có hạn trong Mệnh đề WHERE phải luôn được cung cấp để truy xuất dữ liệu hiệu suất.

SELECT
  segments.date,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’

Khi lọc, điều quan trọng là phân biệt chữ hoa chữ thường của toán tử tâm trí.

Để xem danh sách đầy đủ các toán tử, hãy tham khảo ngữ pháp ngôn ngữ.

ORDER BY

Mệnh đề ORDER BY chỉ định thứ tự xuất hiện kết quả bị trả lại. Tính năng này cho phép bạn sắp xếp dữ liệu theo thứ tự tăng dần hoặc giảm dần dựa trên tên trường. Mỗi thứ tự được chỉ định là một field_name, theo sau là ASC hoặc DESC. Nếu bạn không chỉ định ASC và DESC, thứ tự mặc định thành ASC. Chỉ có thể dùng các trường được chỉ định trong mệnh đề SELECT trong Mệnh đề ORDER BY. Mệnh đề ORDER BY là không bắt buộc trong truy vấn.

Truy vấn sau sắp xếp các hàng được trả về theo số lượt nhấp từ cao nhất đến thấp nhất:

SELECT
  segments.offer_id,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.clicks DESC

Bạn có thể chỉ định nhiều trường trong mệnh đề ORDER BY bằng cách sử dụng dấu phẩy danh sách. Thứ tự này sẽ diễn ra theo cùng một trình tự như đã chỉ định trong truy vấn. Ví dụ: trong truy vấn này, kết quả sẽ được sắp xếp theo thứ tự tăng dần theo offer_id, sau đó theo thứ tự giảm dần theo số lượt hiển thị, sau đó là thứ tự giảm dần theo số lượt nhấp:

SELECT
  segments.offer_id,
  metrics.impressions,
  metrics.clicks
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY
  segments.offer_id,
  metrics.impressions DESC,
  metrics.clicks DESC

LIMIT

Mệnh đề LIMIT cho phép bạn chỉ định số lượng kết quả cần trả về. Cách này rất hữu ích nếu bạn chỉ quan tâm đến bản tóm tắt.

Ví dụ: bạn có thể sử dụng LIMIT để giới hạn tổng số kết quả cho truy vấn sau:

SELECT
  segments.program,
  segments.offer_id,
  metrics.impressions
FROM MerchantPerformanceView
WHERE segments.date BETWEEN ‘2020-08-01’ AND ‘2020-08-31’
ORDER BY metrics.impressions DESC
LIMIT 50
Trước
Ngữ pháp truy vấn
Tiếp
Các phạm vi ngày