rocket
تعرَّف على
Merchant API
الذي يحلّ رسميًا محلّ Content API for Shopping.
add_alert
ملاحظة: سيتم إيقاف Content API for Shopping نهائيًا في 18 أغسطس 2026.
تسعير المنتجات بشكل تنافسي
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكنك استخدام تقرير مكانة السعر في المنافسة لمعرفة الأسعار التي يحدّدها بائعو التجزئة الآخرون للمنتجات نفسها التي تبيعها. يمكنك استخدام هذه المعلومات عند تحديد أسعار منتجاتك أو تقديم عروض أسعار للإعلانات.
يمكنك الاطّلاع على لمحة عن تقرير "مكانة السعر في المنافسة" لمزيد من المعلومات.
يجب أن يستوفي حسابك الحدّ الأدنى من متطلبات الأهلية، ويجب التأكّد من أنّ استخدامك لبيانات برنامج "إحصاءات السوق" التي يتم تصديرها من حسابك على 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
تشغيل
انقر على تنفيذ لتجربة العيّنة في مستكشف واجهات برمجة التطبيقات. بعد النقر على تنفيذ، عدِّل عنصر نائب معرّف التاجر إلى معرّف التاجر الخاص بك في عنوان URL للطلب. يمكنك تعديل طلب البحث. يجب أن يبقى الاستعلام الكامل على سطر واحد لكي يعمل مع مستكشف واجهة برمجة التطبيقات.
في ما يلي نموذج استجابة من طلب البحث السابق:
{
"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 (حسب التوقيت العالمي المتفَّق عليه)
[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 }"]]