rocket
Giới thiệu
Merchant API – API chính thức thay thế cho Content API for Shopping.
add_alert
Lưu ý: Content API for Shopping sẽ ngừng hoạt động từ ngày 18 tháng 8 năm 2026.
Các phạm vi ngày
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Ngôn ngữ truy vấn Merchant Center cho phép bạn chỉ định một phạm vi ngày bằng cách sử dụng phạm vi ngày tuỳ chỉnh hoặc tương đối. Tất cả các yêu cầu về chỉ số đều phải có điều kiện cho segments.date trong mệnh đề WHERE để cho biết khoảng thời gian mà bạn muốn truy xuất dữ liệu hiệu suất.
Phạm vi ngày tùy chỉnh
Bạn có thể chỉ định ngày ở định dạng ISO 8601(YYYY-MM-DD):
segments.date BETWEEN '2021-01-01' AND '2021-01-31'
HOẶC:
segments.date >= '2021-01-01' AND segments.date <= '2021-01-31'
Bạn có thể xác định chuỗi ngày bằng dấu nháy đơn (') hoặc dấu ngoặc kép ("). Tuy nhiên, bạn phải nhất quán; ví dụ: "2021-01-01' không phải là chuỗi ngày hợp lệ.
Phạm vi ngày tương đối
Ngoài phạm vi ngày tuỳ chỉnh, bạn có thể chỉ định phạm vi ngày tương đối, chẳng hạn như LAST_30_DAYS hoặc THIS_MONTH bằng cách sử dụng DURING thay vì BETWEEN và AND:
WHERE segments.date DURING LAST_30_DAYS
Hãy xem cú pháp Ngôn ngữ truy vấn Merchant Center để biết danh sách các khoảng ngày tương đối hiện có.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-13 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-13 UTC."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of the platform.\u003c/p\u003e\n"],["\u003cp\u003eAll Merchant Center Query Language requests for metrics require a \u003ccode\u003esegments.date\u003c/code\u003e condition in the \u003ccode\u003eWHERE\u003c/code\u003e clause to specify the desired time period for performance data retrieval.\u003c/p\u003e\n"],["\u003cp\u003eDate ranges can be specified using custom ISO 8601 formatted dates or relative date ranges like \u003ccode\u003eLAST_30_DAYS\u003c/code\u003e using \u003ccode\u003eDURING\u003c/code\u003e in the \u003ccode\u003eWHERE\u003c/code\u003e clause.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. All requests for performance metrics require a `segments.date` condition in the `WHERE` clause. Dates can be specified in ISO 8601 format within a custom range using `BETWEEN` or `\u003e=` and `\u003c=`. Alternatively, relative date ranges like `LAST_30_DAYS` can be specified with `DURING`. For a list of available date ranges, the grammar documentation should be consulted.\n"],null,["# Date ranges\n\nThe Merchant Center Query Language lets you specify a date range using a custom\nor relative date range. **All requests for metrics must include a condition for\n`segments.date` in the`WHERE` clause** to indicate the time period from which\nyou want to retrieve your performance data.\n\nCustom date range\n-----------------\n\nYou can specify dates in ISO 8601(YYYY-MM-DD) format: \n\n segments.date BETWEEN '2021-01-01' AND '2021-01-31'\n\nOR: \n\n segments.date \u003e= '2021-01-01' AND segments.date \u003c= '2021-01-31'\n\nYou can define date strings with either single quotes (`'`) or double quotes\n(`\"`). However, you must be consistent; for example: `\"2021-01-01'` is not a\nvalid date string.\n\nRelative date range\n-------------------\n\nIn addition to custom date ranges, you can specify a relative date range such\nas `LAST_30_DAYS` or `THIS_MONTH` by using `DURING` instead of `BETWEEN` and\n`AND`: \n\n WHERE segments.date DURING LAST_30_DAYS\n\nCheck out the\n[Merchant Center Query Language grammar](/shopping-content/guides/reports/query-language/grammar)\nfor the list of available relative date ranges."]]
