rocket
Conheça
a
API Merchant
– a sucessora oficial da API Content for Shopping.
update
Fique por dentro
dos novos recursos, correções de bugs e atualizações da API Merchant.
add_alert
Observação: a API Content for Shopping será desativada em 18 de agosto de 2026.
Melhorar preços
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Use a visualização de informações de preço para conferir os preços promocionais sugeridos para seus produtos e as previsões sobre a performance esperada ao atualizar os preços. Ele ajuda a definir valores para seus produtos de forma mais efetiva.
Consulte Melhorar os preços dos produtos com o relatório de informações de preço para mais informações.
Consulte PriceInsightsProductView para ver os preços promocionais sugeridos para seus produtos.
Confira um exemplo que você pode usar para ver os preços promocionais sugeridos para seus produtos. Para fazer a solicitação, transmita a seguinte instrução da linguagem de consulta do Merchant Center ao método 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
Executar
Clique em Executar para testar a amostra no APIs Explorer. Depois de clicar em
Executar, atualize o marcador de posição do ID do comerciante para seu próprio ID no
URL da solicitação. Você pode modificar a consulta. A consulta completa precisa ficar em uma linha para funcionar com o API Explorer.
Confira um exemplo de resposta da consulta anterior:
{
"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"
}
}
]
}
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-13 UTC.
[null,null,["Última atualização 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 }"]]
