معرّفات المنتجات

نودّ إطلاعك على الإصدار التجريبي من Merchant API. إنّه الإصدار الجديد من Content API for Shopping والمستقبل.

للحصول على معلومات حول كيفية تحسين عملية الدمج باستخدام Merchant API وكيفية المساعدة في صياغة المستقبل، يمكنك الاطّلاع على الإعلان عن الإصدار التجريبي من Merchant API.

في ما يلي الأنواع المختلفة لمعرّفات المنتجات في Content API for Shopping:

معرّف العرض الترويجي

السمة offerId هي سلسلة يعيّنها تاجر لمنتج. يمثل هذا المعرّف منتجًا فرديًا.

offerId هي عبارة عن مجموعة من العروض الترويجية في قاعدة بيانات Merchant Center، وعادةً ما تكون رقمًا تسلسليًا رقميًا.

يمكن أن تشير السمة offerId إلى رمز تخزين تعريفي داخلي يحدّده التاجر للمنتج.

رقم تعريف REST

معرّف REST هو المعرّف الفريد لمنتج تحدّده Google.

رقم تعريف REST هو productId لطلبات البيانات من واجهة برمجة التطبيقات REST.

أرقام تعريف REST هي مجموعات بتنسيق online:en:label:1111111111. يتكون رقم تعريف REST من الأجزاء الأربعة التالية، مفصولة بنقطتين:

1. قناة ("على الإنترنت" أو "محلية")
2. لغة المحتوى (باستخدام التصنيف المكوَّن من حرفَين، على سبيل المثال en أو fr)
3. تصنيف الخلاصة (قد يكون الرمز المكوّن من حرفَين للبلد المستهدَف للخلاصة، مثل US أو FR)
4. معرّف العرض الترويجي

لقد جمعتها معًا باسم channel:contentLanguage:feedLabel:offerId، على سبيل المثال، online:en:US:1111111111.

الرقم التعريفي الخارجي للبائع (الأسواق)

يجب تخصيص external_seller_id للعروض التي يتم تحميلها إلى حساب متعدد البائعين في الأسواق. يمثل هذا الحقل بائعًا فرديًا.

قيم external_seller_id حساسة لحالة الأحرف، ويجب أن تستوفي المعايير التالية:

• يتراوح عدد الأحرف بين حرف واحد و50 حرفًا
• أحرف ASCII أبجدية رقمية فقط وشرطة سفلية (_) وواصلة (-) ونقطة (.) وتلدة (~)

ويختلف هذا الحقل عن الحقل seller_id الداخلي.

يلخص الجدول التالي بعض أرقام التعريف التي يمكن ربطها بأحد المنتجات:

السمة	الوصف	مثال	Notes
offerId	معرّف يعيّنه التاجر لمنتج.	1111111111	نوع بيانات السلسلة، وهو معرّف فريد لعرض منتج معيّن
رقم تعريف REST	معرّف عيَّنته Google لمنتج. بالتنسيق channel:contentLanguage:feedLabel:offerId.	online:en:label:1111111111	مستند تعريف الهوية الكامل، بما في ذلك offerId
productId	يتم استخدامه للإشارة إلى رقم تعريف REST في طلبات البيانات من واجهة برمجة التطبيقات.	online:en:label:1111111111	هذا هو معرّف REST الخاص بمنتج.
id	القيمة نفسها كرقم تعريف REST وproductId.	online:en:label:1111111111	يتم استخدام البيانات داخل نص JSON لمنتج للإشارة إلى productId.
external_seller_id	رقم تعريف بائع يختاره السوق.	example-Seller1	هذا الحقل مطلوب للحسابات المتعددة البائعين. ويجب أن يتراوح طوله بين حرف واحد و50 حرفًا. تتأثر بحالة الأحرف. يتم قبول الأرقام والرموز الخاصة _ و- و. و~.