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

في ما يلي الأنواع المختلفة من معرّفات المنتجات في 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 حسّاسة لحالة الأحرف، ويجب أن تستوفي المعايير التالية:

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

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

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

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