في ما يلي الأنواع المختلفة لمعرّفات المنتجات في 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
حساسة لحالة الأحرف، ويجب أن تستوفي المعايير التالية:- يتراوح عدد الأحرف بين حرف واحد و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 حرفًا. تتأثر بحالة الأحرف. يتم قبول الأرقام والرموز الخاصة _ و- و. و~. |