rocket
隆重推出
Merchant API - Content API for Shopping 的正式替代方案。
update
获取最新资讯，了解 Merchant API 的新功能、问题修复和更新。
add_alert
注意：Content API for Shopping 将于 2026 年 8 月 18 日停用。
为商品设置有竞争力的定价
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
您可以使用价格竞争力报告，了解销售同款商品的其他零售商是如何定价的。您可以在为商品定价或为广告出价时使用这些信息。
如需了解详情，请参阅价格竞争力报告简介。
您的账号必须符合最低资格要求，并且您必须确保您或任何第三方在使用从您的 Merchant Center 账号中导出的市场洞察数据时，遵守 Merchant Center 条款及条件。
查询 PriceCompetitivenessProductView，了解其他零售商是如何为与您销售的商品相同的商品定价的。
以下是一个可用于查看价格竞争力数据的示例。如需发出请求，请将以下 Merchant Center 查询语言语句传递给 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
运行
点击运行，即可在 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"
}
"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"
}
}
]
}
如未另行说明，那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可，并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情，请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC)：2025-08-13。
[null,null,["最后更新时间 (UTC)：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 }"]]
