rocket Meet
Merchant API - جانشین رسمی Content API برای خرید.
update جدیدترین ویژگی‌های Merchant API، رفع اشکال‌ها و به‌روزرسانی‌ها
را دریافت کنید .
add_alert توجه: Content API برای خرید در 18 اوت 2026 غروب می‌کند.
بهبود قیمت گذاری
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
می‌توانید از نمای اطلاعات آماری برای مشاهده قیمت‌های پیشنهادی فروش برای محصولات خود و پیش‌بینی‌هایی برای عملکردی که در صورت به‌روزرسانی قیمت‌های محصولات خود انتظار دارید، استفاده کنید. استفاده از گزارش بینش قیمت می تواند به شما در قیمت گذاری موثرتر محصولات کمک کند.
برای اطلاعات بیشتر به بهبود قیمت گذاری محصول با گزارش بینش قیمت مراجعه کنید.
برای مشاهده قیمت های پیشنهادی فروش محصولات خود، PriceInsightsProductView پرس و جو کنید.
در اینجا نمونه ای وجود دارد که می توانید از آن برای مشاهده قیمت های پیشنهادی فروش محصولات خود استفاده کنید. برای ارسال درخواست، عبارت Merchant Center Query Language زیر را به روش 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
اجرا کنید
روی Run کلیک کنید تا نمونه را در API Explorer امتحان کنید. بعد از اینکه روی Run کلیک کردید، مکان‌دار شناسه فروشنده را به شناسه فروشنده خود در URL درخواست به‌روزرسانی کنید. می توانید پرس و جو را اصلاح کنید. جستجوی کامل باید در یک خط باقی بماند تا با کاوشگر 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"
}
}
]
}
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین به‌روزرسانی 2025-08-13 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین به‌روزرسانی 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 }"]]
