rocket
隆重推出
Merchant API - Content API for Shopping 的正式替代方案。
update
获取最新资讯，了解 Merchant API 的新功能、问题修复和更新。
add_alert
注意：Content API for Shopping 将于 2026 年 8 月 18 日停用。
改进定价
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
您可以使用价格分析视图查看商品的建议促销价，以及更新商品价格后的效果预测。使用价格分析报告可以帮助您更有效地为商品定价。
如需了解详情，请参阅借助价格分析报告提高商品价格。
查询 PriceInsightsProductView 以查看建议的商品促销价。
您可以参考以下示例来查看商品的建议售价。如需发出请求，请将以下 Merchant Center 查询语言语句传递给 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
运行
点击运行，即可在 API Explorer 中试用该示例。点击运行后，请将请求网址中的商家 ID 占位符更新为您自己的商家 ID。您可以修改查询。完整查询必须保持在一行中，才能与 API 浏览器搭配使用。
以下是上述查询的示例回答：
{
"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"
}
}
]
}
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-13。
[null,null,["最后更新时间 (UTC)：2025-08-13。"],[[["\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 }"]]
