في ما يلي الأنواع المختلفة من معرّفات المنتجات في Content API for Shopping:
- معرّف العرض
offerIdعبارة عن سلسلة يحدّدها أحد التجّار لمنتج معيّن. يمثل هذا الرقم التعريفي منتجًا فرديًا.- تتميز خدمة
offerIdبمجموعة من العروض في قاعدة بيانات Merchant Center، وعادةً ما تكون رقمًا تسلسليًا رقميًا. - يمكن أن يكون
offerIdرقم رمز التخزين التعريفي الداخلي الذي يحدّده التاجر للمنتج. - رقم تعريف REST
- معرّف REST هو المعرّف الفريد للمنتج الذي تحدّده Google.
- معرّف REST هو
productIdلاستدعاء واجهة برمجة تطبيقات REST. يتم تجميع أرقام تعريف REST بالتنسيق
online:en:label:1111111111. يتألف معرّف REST من الأجزاء الأربعة التالية مفصولة بفواصل:- القناة ("عبر الإنترنت" أو "المحلية")
- لغة المحتوى (باستخدام التصنيف المكوَّن من حرفين، على سبيل المثال
enأوfr) - تصنيف الخلاصة (قد يكون رمزًا من حرفين للبلد المستهدف للخلاصة، على سبيل المثال
USأوFR) - معرّف العرض
لقد جمعت هذه البيانات معًا كـ
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 حرفًا. تتأثر بحالة الأحرف. يتم قبول الأرقام والأحرف الخاصة _ و- و. و~. |