شناسه محصولات

مایلیم نسخه بتا Merchant API را معرفی کنیم. این نسخه جدید Content API برای خرید و آینده است.

برای اطلاعات در مورد اینکه Merchant API چگونه می‌تواند ادغام شما را بهبود بخشد و چگونه می‌توانید به شکل‌دهی آینده کمک کنید، به اعلام Merchant API Beta مراجعه کنید.

در اینجا انواع مختلف شناسه محصول در 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 قسمت زیر است که با دو نقطه از هم جدا شده اند:

1. کانال ("آنلاین" یا "محلی")
2. زبان محتوا (با استفاده از علامت 2 حرفی، به عنوان مثال en یا fr )
3. برچسب فید (ممکن است کد دو حرفی برای کشور هدف فید باشد، به عنوان مثال US یا FR )
4. شناسه پیشنهاد

شما این را به عنوان 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 کاراکتر باشد. حساس به حروف کوچک و بزرگ. ارقام و کاراکترهای خاص _، -، .، و ~ پذیرفته می شوند.