Bạn có thể gửi các truy vấn về các trường chỉ số và phân đoạn đến phương thức 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 truy vấn bằng cách sử dụng ngữ pháp ngôn ngữ. Một truy vấn được tạo thành từ một số mệnh đề:
SELECT
FROM
WHERE
ORDER BY
LIMIT
Các 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 kết hợp thành một truy vấn, bạn có thể thực hiện yêu cầu bằng cách sử dụng Google Content API for Shopping. Hãy xem cách sử dụng của từng mệnh đề.
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 phản hồ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 các hạn chế sau:
- 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. Bảng trong mệnh đề FROM
xác định trường nào có thể được tất cả các mệnh đề khác sử dụng cho truy vấn nhất định. 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 đến 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 yêu cầu. 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 AND
để phân tách các điều kiện đó. Mỗi điều kiện phải tuân theo mẫu field_name Operator value
. Bạn có thể sử dụng bất kỳ trường phân đoạn nào trong mệnh đề WHERE
, nhưng cần chỉ định các trường chỉ số trong mệnh đề SELECT
thì mới được sử dụng trong mệnh đề WHERE
. Mệnh đề WHERE
là bắt buộc trong truy vấn, vì bạn phải luôn chỉ định phạm vi ngày 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ố trong một khoảng thời gian nhất định:
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 của chương trình SHOPPING_ADS mà trong đó số lượt nhấp > 100 trong khoảng thời gian 30 ngày nhất định.
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, bạn luôn phải cung cấp phạm vi ngày hữu hạn trong mệnh đề WHERE
để 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ử.
Để biết danh sách đầy đủ các toán tử, hãy tham khảo phần ngữ pháp ngôn ngữ.
ORDER BY
Mệnh đề ORDER BY
chỉ định thứ tự trả về kết quả. Nhờ đó, bạn có thể 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 cả ASC
và DESC
đều không được chỉ định, thì thứ tự mặc định sẽ là ASC
. Bạn chỉ có thể sử 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 đây 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 danh sách được phân tách bằng dấu phẩy. 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 đó theo 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
GIỚI HẠN
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ể dùng LIMIT
để hạn chế 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