rocket
Meet
Merchant API
- the official successor to Content API for Shopping.
update
עדכונים אחרונים
לגבי תכונות חדשות, תיקוני באגים וגרסאות חדשות של Merchant API
add_alert
הערה: אנחנו נוציא משימוש את Content API for Shopping ב-18 באוגוסט 2026.
תמחור מוצרים תחרותי
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בדוח השוואת מחירים ביחס לשוק אפשר לראות את המחיר שבו מוצרים שאתם משווקים נמכרים אצל קמעונאים אחרים. אתם יכולים להשתמש במידע הזה כשאתם קובעים את מחירי המוצרים או מגישים הצעות מחיר למודעות.
מידע נוסף זמין במאמר מידע על הדוח 'השוואת מחירים ביחס לשוק'.
החשבון שלכם צריך לעמוד בדרישות הסף המינימליות, ועליכם לוודא שהשימוש שלכם או של כל צד שלישי בנתונים של Market Insights שמיוצאים מחשבון Merchant Center שלכם נעשה בהתאם לתנאים ולהגבלות של Merchant Center.
שאילתה
PriceCompetitivenessProductView
כדי לראות את המחיר שבו מוכרים אחרים מתמחרים את אותם מוצרים שאתם מוכרים.
הנה דוגמה שאפשר להשתמש בה כדי לראות נתונים של השוואת מחירים ביחס לשוק. כדי לשלוח את הבקשה, מעבירים את ההצהרה הבאה של Merchant Center Query Language (MCQL) אל השיטה 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
לוחצים על Run כדי לנסות את הדוגמה ב-API Explorer. אחרי שלוחצים על Run (הפעלה), מעדכנים את placeholder (שומר המקום) של מזהה המוכר למזהה המוכר שלכם בכתובת ה-URL של הבקשה. אפשר לשנות את השאילתה. כדי שהשאילתה תפעל עם API Explorer, היא צריכה להיות בשורה אחת.
זוהי דוגמה לתשובה מהשאילתה הקודמת:
{
"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 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-13 (שעון UTC).
[null,null,["עדכון אחרון: 2025-08-13 (שעון UTC)."],[[["\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 }"]]