rocket Meet
Merchant API - جانشین رسمی Content API برای خرید.
update جدیدترین ویژگیهای Merchant API، رفع اشکالها و بهروزرسانیها
را دریافت کنید .
add_alert توجه: Content API برای خرید در 18 اوت 2026 غروب میکند.
قیمت محصولات به صورت رقابتی
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
میتوانید از گزارش رقابتپذیری قیمت برای اطلاع از نحوه قیمتگذاری سایر خردهفروشان برای محصولاتی که شما میفروشید استفاده کنید. می توانید از این اطلاعات زمانی که محصولات خود را قیمت گذاری می کنید یا برای تبلیغات مناقصه می دهید استفاده کنید.
برای اطلاعات بیشتر به گزارش رقابت قیمتی مراجعه کنید.
حساب شما باید حداقل شرایط واجد شرایط بودن را داشته باشد و باید اطمینان حاصل کنید که استفاده شما یا استفاده شخص ثالث از دادههای Market Insights صادر شده از حساب Merchant Center شما با شرایط و ضوابط Merchant Center مطابقت دارد.
PriceCompetitivenessProductView
را پرس و جو کنید تا بدانید سایر خرده فروشان چگونه محصولاتی را که شما می فروشید قیمت گذاری می کنند.
در اینجا نمونه ای وجود دارد که می توانید برای مشاهده داده های رقابت قیمت از آن استفاده کنید. برای ارسال درخواست، عبارت 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_competitiveness.country_code,
price_competitiveness.benchmark_price_micros,
price_competitiveness.benchmark_price_currency_code
FROM PriceCompetitivenessProductView
اجرا کنید
روی 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"
}
"priceCompetitiveness": {
"countryCode": "US",
"benchmarkPriceMicros": "119922291",
"benchmarkPriceCurrencyCode": "USD"
}
},
{
"productView": {
"id": "online:en:US:12346",
"title": "Nike React Infinity Run Flyknit 2",
"brand": "Nike",
"priceMicros": "119990000"
"currencyCode": "USD"
}
"priceCompetitiveness": {
"countryCode": "US",
"benchmarkPriceMicros": "173436840",
"benchmarkPriceCurrencyCode": "USD"
}
},
{
"productView": {
"id": "online:en:US:12347",
"title": "New Balance 327 White Trainers",
"brand": "New Balance",
"priceMicros": "84990000"
"currencyCode": "USD"
}
"priceCompetitiveness": {
"countryCode": "US",
"benchmarkPriceMicros": "85459050",
"benchmarkPriceCurrencyCode": "USD"
}
}
]
}
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز 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, a new version of the Content API for Shopping, is now in beta and represents the future of product data integration.\u003c/p\u003e\n"],["\u003cp\u003eMerchants can use the price competitiveness report and the \u003ccode\u003ePriceCompetitivenessProductView\u003c/code\u003e query to compare their product pricing with competitors.\u003c/p\u003e\n"],["\u003cp\u003eAccounts must meet eligibility requirements and adhere to the Merchant Center terms and conditions for using Market Insights data.\u003c/p\u003e\n"],["\u003cp\u003eA sample query and response are provided to demonstrate how to retrieve price competitiveness data using the \u003ccode\u003ereports.search\u003c/code\u003e method.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. Users can access the price competitiveness report to view how other retailers price the same products. To use this data, accounts must meet eligibility requirements and comply with Merchant Center terms. Data is accessed by querying `PriceCompetitivenessProductView` via the `reports.search` method, as shown in the provided sample, and can be run on the API explorer. The sample response displays price and product comparison.\n"],null,["# Price products competitively\n\nYou can use the [price competitiveness](//support.google.com/merchants/answer/9626903) report to learn how other retailers are pricing the same products that you sell. You can use this information when you're pricing your products or bidding on ads.\n\nSee [About the price competitiveness\nreport](//support.google.com/merchants/answer/9626903) for more information.\n\n\nYour account must meet minimum eligibility requirements, and you must ensure that your use, or any third party's use, of Market Insights data exported from your Merchant Center account complies with the [Merchant Center terms and conditions](//support.google.com/merchants/answer/160173).\n\nQuery\n[`PriceCompetitivenessProductView`](/shopping-content/guides/reports/fields#pricecompetitivenessproductview) to learn how other retailers are pricing the same products that you sell.\n\nHere's a sample you can use to view price competitiveness data. 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, product_view.currency_code,\n price_competitiveness.country_code,\n price_competitiveness.benchmark_price_micros,\n price_competitiveness.benchmark_price_currency_code\n FROM PriceCompetitivenessProductView\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%20product_view.currency_code%2C%20%20price_competitiveness.country_code%2C%20%20price_competitiveness.benchmark_price_micros%2C%20%20price_competitiveness.benchmark_price_currency_code%20FROM%20PriceCompetitivenessProductView%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 \"priceCompetitiveness\": {\n \"countryCode\": \"US\",\n \"benchmarkPriceMicros\": \"119922291\",\n \"benchmarkPriceCurrencyCode\": \"USD\"\n }\n },\n {\n \"productView\": {\n \"id\": \"online:en:US:12346\",\n \"title\": \"Nike React Infinity Run Flyknit 2\",\n \"brand\": \"Nike\",\n \"priceMicros\": \"119990000\"\n \"currencyCode\": \"USD\"\n }\n \"priceCompetitiveness\": {\n \"countryCode\": \"US\",\n \"benchmarkPriceMicros\": \"173436840\",\n \"benchmarkPriceCurrencyCode\": \"USD\"\n }\n },\n {\n \"productView\": {\n \"id\": \"online:en:US:12347\",\n \"title\": \"New Balance 327 White Trainers\",\n \"brand\": \"New Balance\",\n \"priceMicros\": \"84990000\"\n \"currencyCode\": \"USD\"\n }\n \"priceCompetitiveness\": {\n \"countryCode\": \"US\",\n \"benchmarkPriceMicros\": \"85459050\",\n \"benchmarkPriceCurrencyCode\": \"USD\"\n }\n }\n ]\n }"]]