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ải thiện giá
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.
Bạn có thể sử dụng chế độ xem thông tin chi tiết về giá để xem giá ưu đãi được đề xuất cho sản phẩm và dự đoán hiệu suất mà bạn có thể đạt được nếu cập nhật giá sản phẩm. Việc khai thác báo cáo thông tin chi tiết về giá có thể giúp bạn định giá sản phẩm một cách hiệu quả hơn.
Hãy xem bài viết Cải thiện cách định giá sản phẩm bằng báo cáo thông tin chi tiết về giá để biết thêm thông tin.
Truy vấn PriceInsightsProductView để xem giá ưu đãi được đề xuất cho sản phẩm của bạn.
Sau đây là một mẫu mà bạn có thể dùng để xem giá ưu đãi được đề xuất cho sản phẩm của mình. Để đưa ra yêu cầu, hãy truyền câu lệnh sau bằng Ngôn ngữ truy vấn Merchant Center đến phương thức reports.search:
SELECT
product_view.id, product_view.title, product_view.brand,
product_view.price_micros,
product_view.currency_code, price_insights.suggested_price_micros,
price_insights.suggested_price_currency_code,
price_insights.predicted_impressions_change_fraction,
price_insights.predicted_clicks_change_fraction,
price_insights.predicted_conversions_change_fraction
FROM PriceInsightsProductView
Chạy
Nhấp vào Run (Chạy) để dùng thử mẫu trong API Explorer. Sau khi bạn nhấp vào Chạy, hãy cập nhật phần giữ chỗ mã người bán thành mã người bán của riêng bạn trong URL yêu cầu. Bạn có thể sửa đổi câu hỏi. Toàn bộ truy vấn phải nằm trên một dòng để hoạt động với trình khám phá API.
Sau đây là một phản hồi mẫu từ truy vấn trước:
{
"results": [
{
"productView": {
"id": "online:en:US:12345",
"title": "UGG Women's s Classic Mini",
"brand": "UGG",
"priceMicros": "124990000"
"currencyCode": "USD"
}
"priceInsights": {
"suggestedPriceMicros": "135680000",
"suggestedPriceCurrencyCode": "USD",
"predictedImpressionsChangeFraction": "0.12609300017356873",
"predictedClicksChangeFraction": "0.508745014667511",
"predictedConversionsChangeFraction": "2.3431060314178467"
}
},
{
"productView": {
"id": "online:en:US:12346",
"title": "Nike React Infinity Run Flyknit 2",
"brand": "Nike",
"categoryL1": "Apparel & Accessories",
"priceMicros": "119990000"
"currencyCode": "USD"
}
"priceInsights": {
"suggestedPriceMicros": "125440000",
"suggestedPriceCurrencyCode": "USD",
"predictedImpressionsChangeFraction": "0.1799899935722351",
"predictedClicksChangeFraction": "0.6203680038452148",
"predictedConversionsChangeFraction": "1.234868049621582"
}
},
{
"productView": {
"id": "online:en:US:12347",
"title": " New Balance 327 White Trainers",
"brand": "New Balance",
"categoryL1": "Apparel & Accessories",
"priceMicros": "84990000"
"currencyCode": "USD"
}
"priceInsights": {
"suggestedPriceMicros": "82000000",
"suggestedPriceCurrencyCode": "USD",
"predictedImpressionsChangeFraction": "0.11538799852132797",
"predictedClicksChangeFraction": "0.5869849920272827",
"predictedConversionsChangeFraction": "1.3622850179672241"
}
}
]
}
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 product data integration.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the Price Insights report to see suggested sale prices for your products and predictions for performance changes.\u003c/p\u003e\n"],["\u003cp\u003eQuery \u003ccode\u003ePriceInsightsProductView\u003c/code\u003e to retrieve suggested sale prices, predicted impressions, clicks, and conversions change fraction based on price adjustments.\u003c/p\u003e\n"],["\u003cp\u003eA sample query and response demonstrate how to use the \u003ccode\u003ereports.search\u003c/code\u003e method to access price insights data for your products.\u003c/p\u003e\n"]]],["The Merchant API beta, a new version of the Content API for Shopping, is introduced. The price insights view suggests optimal sale prices and predicts performance outcomes based on price changes. Users can query `PriceInsightsProductView` using a specific Merchant Center Query Language statement to access this data. A sample query and its response are provided, detailing product ID, title, brand, current price, suggested price, and predicted performance metrics like impressions, clicks, and conversions. The **API Explorer** can run the query using your merchant ID.\n"],null,["# Improve pricing\n\nYou can use the price insights view to see suggested sale prices for\nyour products, and predictions for the performance that you can expect if you\nupdate your products' prices. Using the price insights report can help you price\nyour products more effectively.\n\nSee [Improve product pricing with the price insights report](//support.google.com/merchants/answer/11916926) for more information.\n\nQuery\n[`PriceInsightsProductView`](/shopping-content/guides/reports/fields#priceinsightsproductview) to view suggested sale prices for your products.\n\nHere's a sample you can use to view suggested sales prices for your products. To make the request, pass the following Merchant Center Query Language statement to the [`reports.search`](/shopping-content/reference/rest/v2.1/reports/search) method: \n\n SELECT\n product_view.id, product_view.title, product_view.brand,\n product_view.price_micros, \n product_view.currency_code, price_insights.suggested_price_micros,\n price_insights.suggested_price_currency_code,\n price_insights.predicted_impressions_change_fraction,\n price_insights.predicted_clicks_change_fraction,\n price_insights.predicted_conversions_change_fraction\n FROM PriceInsightsProductView\n\n[Run](https://developers.google.com/shopping-content/reference/rest/v2.1/reports/search?apix=true&apix_params=%7B%22merchantId%22%3A0%2C%22resource%22%3A%7B%22query%22%3A%22SELECT%20%20product_view.id%2C%20product_view.title%2C%20product_view.brand%2C%20%20product_view.price_micros%2C%20%20%20product_view.currency_code%2C%20price_insights.suggested_price_micros%2C%20%20price_insights.suggested_price_currency_code%2C%20%20price_insights.predicted_impressions_change_fraction%2C%20%20price_insights.predicted_clicks_change_fraction%2C%20%20price_insights.predicted_conversions_change_fraction%2C%20%20price_insights.predicted_gross_profit_change_fraction%2C%20%20price_insights.predicted_monthly_gross_profit_change_micros%2C%20%20price_insights.predicted_monthly_gross_profit_change_currency_code%20FROM%20PriceInsightsProductView%22%7D%7D)\n\nClick **Run** to try the sample in the **API Explorer** . After you click\n**Run** , update the merchant ID placeholder to your own merchant ID in the\nrequest URL. You can modify the query. The full query must remain on one line to\nwork with the **API explorer**.\n\nHere's a sample response from the preceding query: \n\n {\n \"results\": [\n {\n \"productView\": {\n \"id\": \"online:en:US:12345\",\n \"title\": \"UGG Women's s Classic Mini\",\n \"brand\": \"UGG\",\n \"priceMicros\": \"124990000\"\n \"currencyCode\": \"USD\"\n }\n \"priceInsights\": {\n \"suggestedPriceMicros\": \"135680000\",\n \"suggestedPriceCurrencyCode\": \"USD\",\n \"predictedImpressionsChangeFraction\": \"0.12609300017356873\",\n \"predictedClicksChangeFraction\": \"0.508745014667511\",\n \"predictedConversionsChangeFraction\": \"2.3431060314178467\"\n }\n },\n {\n \"productView\": {\n \"id\": \"online:en:US:12346\",\n \"title\": \"Nike React Infinity Run Flyknit 2\",\n \"brand\": \"Nike\",\n \"categoryL1\": \"Apparel & Accessories\",\n \"priceMicros\": \"119990000\"\n \"currencyCode\": \"USD\"\n }\n \"priceInsights\": {\n \"suggestedPriceMicros\": \"125440000\",\n \"suggestedPriceCurrencyCode\": \"USD\",\n \"predictedImpressionsChangeFraction\": \"0.1799899935722351\",\n \"predictedClicksChangeFraction\": \"0.6203680038452148\",\n \"predictedConversionsChangeFraction\": \"1.234868049621582\"\n }\n },\n {\n \"productView\": {\n \"id\": \"online:en:US:12347\",\n \"title\": \" New Balance 327 White Trainers\",\n \"brand\": \"New Balance\",\n \"categoryL1\": \"Apparel & Accessories\",\n \"priceMicros\": \"84990000\"\n \"currencyCode\": \"USD\"\n }\n \"priceInsights\": {\n \"suggestedPriceMicros\": \"82000000\",\n \"suggestedPriceCurrencyCode\": \"USD\",\n \"predictedImpressionsChangeFraction\": \"0.11538799852132797\",\n \"predictedClicksChangeFraction\": \"0.5869849920272827\",\n \"predictedConversionsChangeFraction\": \"1.3622850179672241\"\n }\n }\n ]\n }"]]
