点击运行,即可在 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"}}]}
[[["易于理解","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"]],["最后更新时间 (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 }"]]