按一下「執行」,在 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"}}]}
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["缺少我需要的資訊","missingTheInformationINeed","thumb-down"],["過於複雜/步驟過多","tooComplicatedTooManySteps","thumb-down"],["過時","outOfDate","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["示例/程式碼問題","samplesCodeIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間: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 }"]]