rocket Meet
Merchant API - جانشین رسمی Content API برای خرید.
update جدیدترین ویژگی‌های Merchant API، رفع اشکال‌ها و به‌روزرسانی‌ها
را دریافت کنید .
add_alert توجه: Content API برای خرید در 18 اوت 2026 غروب می‌کند.
شناسه محصولات
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
در اینجا انواع مختلف شناسه محصول در Content API برای خرید آمده است:
- شناسه پیشنهاد
-
offerId رشته‌ای است که توسط یک تاجر به یک محصول اختصاص داده می‌شود. این شناسه نشان دهنده یک محصول جداگانه است. -
offerId برای مجموعه پیشنهادات در پایگاه داده Merchant Center منحصر به فرد است و معمولاً یک عدد ترتیبی عددی است. -
offerId می تواند یک شماره SKU داخلی باشد که یک تاجر به محصول اختصاص می دهد. - REST ID
- REST ID شناسه منحصربه‌فرد برای محصولی است که توسط Google اختصاص داده شده است.
- REST ID
productId برای تماس‌های REST API است. شناسه‌های REST مجموعه‌هایی با قالب online:en:label:1111111111 هستند. REST ID شامل 4 قسمت زیر است که با دو نقطه از هم جدا شده اند:
- کانال ("آنلاین" یا "محلی")
- زبان محتوا (با استفاده از علامت 2 حرفی، به عنوان مثال
en یا fr ) - برچسب فید (ممکن است کد دو حرفی برای کشور هدف فید باشد، به عنوان مثال
US یا FR ) - شناسه پیشنهاد
شما این را به عنوان channel:contentLanguage:feedLabel:offerId ، به عنوان مثال، online:en:US:1111111111 کنار هم قرار می دهید.
- شناسه فروشنده خارجی (Marketplaces)
Marketplaces باید یک external_seller_id به پیشنهادات آپلود شده در یک حساب چند فروشنده اختصاص دهد. این فیلد نشان دهنده یک فروشنده فردی است.
مقادیر external_seller_id به حروف بزرگ و کوچک حساس هستند و باید معیارهای زیر را داشته باشند:
- طول 1 تا 50 کاراکتر
- فقط کاراکترهای ASCII الفبایی و زیرخط (_)، خط فاصله (-)، نقطه (.) و تایلد (~)
این با فیلد داخلی seller_id یکسان نیست.
جدول زیر برخی از شناسه هایی را که می توان با یک محصول مرتبط کرد خلاصه می کند:
| صفت | شرح | مثال | یادداشت |
|---|
offerId | شناسه ای که یک تاجر به یک محصول اختصاص داده است. | 1111111111 | نوع داده رشته، شناسه منحصر به فرد برای پیشنهاد محصول. |
| REST ID | شناسه‌ای که Google به یک محصول اختصاص داده است. در قالب channel:contentLanguage:feedLabel:offerId . | online:en:label:1111111111 | شناسه کامل شامل offerId . |
productId | برای ارجاع به REST ID در تماس های API استفاده می شود. | online:en:label:1111111111 | این شناسه REST یک محصول است. |
id | همان مقدار REST ID و productId . | online:en:label:1111111111 | در داخل بدنه JSON محصول برای ارجاع به productId آن استفاده می شود. |
external_seller_id | شناسه فروشنده انتخاب شده توسط Marketplace. | example-Seller1 | برای حساب های چند فروشنده مورد نیاز است. باید 1 تا 50 کاراکتر باشد. حساس به حروف کوچک و بزرگ. ارقام و کاراکترهای خاص _، -، .، و ~ پذیرفته می شوند. |
،
در اینجا انواع مختلف شناسه محصول در Content API برای خرید آمده است:
- شناسه پیشنهاد
-
offerId رشته‌ای است که توسط یک تاجر به یک محصول اختصاص داده می‌شود. این شناسه نشان دهنده یک محصول جداگانه است. -
offerId برای مجموعه پیشنهادات در پایگاه داده Merchant Center منحصر به فرد است و معمولاً یک عدد ترتیبی عددی است. -
offerId می تواند یک شماره SKU داخلی باشد که یک تاجر به محصول اختصاص می دهد. - REST ID
- REST ID شناسه منحصربه‌فرد برای محصولی است که توسط Google اختصاص داده شده است.
- REST ID
productId برای تماس‌های REST API است. شناسه‌های REST مجموعه‌هایی با قالب online:en:label:1111111111 هستند. REST ID شامل 4 قسمت زیر است که با دو نقطه از هم جدا شده اند:
- کانال ("آنلاین" یا "محلی")
- زبان محتوا (با استفاده از علامت 2 حرفی، به عنوان مثال
en یا fr ) - برچسب فید (ممکن است کد دو حرفی برای کشور هدف فید باشد، به عنوان مثال
US یا FR ) - شناسه پیشنهاد
شما این را به عنوان channel:contentLanguage:feedLabel:offerId ، به عنوان مثال، online:en:US:1111111111 کنار هم قرار می دهید.
- شناسه فروشنده خارجی (Marketplaces)
Marketplaces باید یک external_seller_id به پیشنهادات آپلود شده در یک حساب چند فروشنده اختصاص دهد. این فیلد نشان دهنده یک فروشنده فردی است.
مقادیر external_seller_id به حروف بزرگ و کوچک حساس هستند و باید معیارهای زیر را داشته باشند:
- طول 1 تا 50 کاراکتر
- فقط کاراکترهای ASCII الفبایی و زیرخط (_)، خط فاصله (-)، نقطه (.) و تایلد (~)
این با فیلد داخلی seller_id یکسان نیست.
جدول زیر برخی از شناسه هایی را که می توان با یک محصول مرتبط کرد خلاصه می کند:
| صفت | شرح | مثال | یادداشت |
|---|
offerId | شناسه ای که یک تاجر به یک محصول اختصاص داده است. | 1111111111 | نوع داده رشته، شناسه منحصر به فرد برای پیشنهاد محصول. |
| REST ID | شناسه‌ای که Google به یک محصول اختصاص داده است. در قالب channel:contentLanguage:feedLabel:offerId . | online:en:label:1111111111 | شناسه کامل شامل offerId . |
productId | برای ارجاع به REST ID در تماس های API استفاده می شود. | online:en:label:1111111111 | این شناسه REST یک محصول است. |
id | همان مقدار REST ID و productId . | online:en:label:1111111111 | در داخل بدنه JSON محصول برای ارجاع به productId آن استفاده می شود. |
external_seller_id | شناسه فروشنده انتخاب شده توسط Marketplace. | example-Seller1 | برای حساب های چند فروشنده مورد نیاز است. باید 1 تا 50 کاراکتر باشد. حساس به حروف کوچک و بزرگ. ارقام و کاراکترهای خاص _، -، .، و ~ پذیرفته می شوند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز 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 is the new version of the Content API for Shopping and represents the future of product data integration with Google.\u003c/p\u003e\n"],["\u003cp\u003eThe beta version of the Merchant API is now available for developers to explore and help shape its future development.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can learn more about the benefits and features of the Merchant API, including how it can enhance integrations, in the official announcement blog post.\u003c/p\u003e\n"],["\u003cp\u003eProducts in the Merchant API are identified using various IDs, such as \u003ccode\u003eofferId\u003c/code\u003e, REST ID, \u003ccode\u003eproductId\u003c/code\u003e, and \u003ccode\u003eexternal_seller_id\u003c/code\u003e, each with specific characteristics and usage contexts.\u003c/p\u003e\n"],["\u003cp\u003eA comprehensive table provides detailed explanations and examples of different product ID attributes, outlining their purpose and format.\u003c/p\u003e\n"]]],["The beta version of the Merchant API, the new Content API for Shopping, is introduced. Merchants assign an `offerId` to products. Google assigns a unique REST ID in the format `channel:contentLanguage:feedLabel:offerId`; this is also the `productId` and `id` in API calls. Marketplaces assign `external_seller_id` to offers for multi-seller accounts, it has specific format requirements. The Merchant API offers integration improvements; details on this and providing feedback are available via a linked article.\n"],null,["# Product IDs\n\nHere are the different kinds of product IDs in the Content API for Shopping:\n\nOffer ID\n: An `offerId` is a string assigned to a product by a merchant. This ID\n represents an individual product.\n: `offerId` is unique to the set of offers in the Merchant Center database, and\n is usually a numeric sequential number.\n: `offerId` can be an internal SKU number that a merchant assigns to the product.\n\nREST ID\n: A REST ID is the unique identifier for a product assigned by Google.\n: REST ID is the `productId` for REST API calls.\n\n: REST IDs are aggregates with the format `online:en:label:1111111111`. The\n REST ID consists of the following 4 parts, separated by colons:\n\n 1. Channel (\"online\" or \"local\")\n 2. Content Language (using the 2-letter designation, for example `en` or `fr`)\n 3. Feed label (might be the two-letter code for the feed's target country, for example `US` or `FR`)\n 4. Offer ID\n\n: You put this together as `channel:contentLanguage:feedLabel:offerId`, for\n example, `online:en:US:1111111111`.\n\nExternal Seller ID (Marketplaces)\n\n: [Marketplaces](//support.google.com/merchants/answer/6363319)\n must assign an `external_seller_id` to offers uploaded to a multi-seller\n account. This field represents an individual seller.\n\n `external_seller_id` values are case-sensitive, and must meet the following\n criteria:\n\n - 1-50 characters in length\n - Only alphanumeric ASCII characters, and underscore (_), hyphen (-), period (.), and tilde (\\~)\n\n This isn't the same as the internal\n [`seller_id`](/shopping-content/reference/rest/v2.1/accounts) field.\n\nThe following table summarizes some of the IDs that can be associated with a\nproduct:\n\n| Attribute | Description | Example | Notes |\n|----------------------|---------------------------------------------------------------------------------------------------|------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------|\n| `offerId` | An ID assigned to a product by a merchant. | `1111111111` | String data type, unique identifier for a product's offer. |\n| REST ID | An ID assigned to a product by Google. In the format `channel:contentLanguage:feedLabel:offerId`. | `online:en:label:1111111111` | Full ID including `offerId`. |\n| `productId` | Used to refer to the REST ID in API calls. | `online:en:label:1111111111` | This is the REST ID of a product. |\n| `id` | Same value as REST ID and `productId`. | `online:en:label:1111111111` | Used inside JSON body of a product to refer to its `productId`. |\n| `external_seller_id` | A seller ID chosen by the Marketplace. | `example-Seller1` | Required for multi-seller accounts. Must be 1-50 characters. Case-sensitive. Digits, and special characters _, -, ., and \\~ are accepted. |"]]
