getFrequentlyOrderedProducts

الحصول على المنتجات التي يتم طلبها بشكل متكرر حسب علامة الكتلة ومعرف المنتج.

الوصف

ترجع هذه الطريقة المنتجات التي يتم طلبها بشكل متكرر المرتبطة بعلامة كتلة معينة ومعرف منتج. ترجع وعدًا (Promise) يتم حله إلى كائن IProductsResponse.

Blocks.getFrequentlyOrderedProducts(

productId*, marker*, langCode, signPrice, limit

);

مخطط المعلمات

المخطط

productId(مطلوب): number
معرف المنتج
مثال: 1

marker(مطلوب): string
علامة الكتلة
مثال: "frequently_ordered_block"

langCode: string
رمز اللغة. الافتراضي: "en_US"
مثال: "en_US"

signPrice: string
علامة تخزين الطلب لتثبيت السعر. إذا تم تعيين المعامل، يتم تثبيت السعر لفترة معينة
انظر: تثبيت السعر

limit: number
الحد الأقصى لعدد المنتجات التي يجب إرجاعها. عند الإغفال، يتم تطبيق إعداد الكمية الخاص بالكتلة
مثال: 10

💲 signPrice يقفل السعر المعاد لفترة محدودة — قم بتعيينه إلى علامة تخزين الطلب الخاصة بك. انظر تثبيت السعر (signPrice).

أمثلة

مثال بسيط

const response = await Blocks.getFrequentlyOrderedProducts(1, 'my-block');

مثال مع السمات

const response = await Blocks.getFrequentlyOrderedProducts(1, 'my-block', 'en_US');

مثال مع الحد

const response = await Blocks.getFrequentlyOrderedProducts(1, 'my-block', 'en_US', undefined, 4);

🔢 limit يحدد عدد المنتجات التي يتم إرجاعها. إذا تم إغفاله، فإن إعداد الكمية الخاص بالكتلة من لوحة الإدارة يستمر في التطبيق. انظر تحديد عدد المنتجات (limit).

مثال على الاستجابة

{
  "items": [],
  "total": 0,
  "totalFound": 0,
  "fallbackUsed": true
}

مخطط الاستجابة

المخطط: IProductsResponse

total: number
إجمالي عدد المنتجات الموجودة.
مثال: 100

items: IProductsEntity[]
مصفوفة من كائنات المنتجات.
مثال:

[
  {
    "id": 12345,
    "title": "Product 1"
  },
  {
    "id": 67890,
    "title": "Product 2"
  }
]

items.id: number
المعرف الفريد.
مثال: 12345

items.localizeInfos: ILocalizeInfo
اسم المنتجات، مع الأخذ في الاعتبار التوطين.
مثال:

{}

items.statusIdentifier: string | null
معرفات حالة صفحة المنتج (قد تكون null).
مثال: "in_stock"

items.statusLocalizeInfos: ILocalizeInfo
اسم الحالة المحلي للمنتج.
مثال:

{ "title": "Sale" }

items.attributeSetIdentifier: string | null
مجموعة معرفات السمات.
مثال: "set_12345"

items.position: number
رقم العنصر (لترتيب العناصر).
مثال: 1

items.price: number | null
قيمة سعر صفحة المنتج المأخوذة من الفهرس.
مثال: 150.00

items.additional: object
قيمة إضافية من الفهرس.
مثال:

{
  "prices": {
    "min": 5,
    "max": 150
  }
}

items.sku: string | null
SKU المنتج (وحدة حفظ المخزون)، قد تكون null.
مثال: "SKU_12345"

items.isSync: boolean
إشارة إلى فهرسة الصفحة.
مثال: true

items.attributeValues: IAttributeValues
مصفوفة من قيم السمات من الفهرس، ممثلة.
مثال:

[
  {
    "id": "color",
    "value": "red"
  }
]

items.categories: string[]
فئات المنتج.
مثال:

[
  1,
  2,
  3
]

items.isVisible: boolean
علامة رؤية الصفحة.
مثال: true

items.moduleFormConfigs: Array<IFormConfig>
تكوينات نماذج الوحدة (اختياري).

items.rating: IRating
بيانات التقييم.

items.isPositionLocked: boolean
مؤشر قفل موضع الترتيب (اختياري).
مثال: false

items.relatedIds: number[]
معرفات صفحات المنتجات ذات الصلة.
مثال:

[
  12345,
  67890
]

items.paymentStages: unknown
بيانات مراحل الدفع (قد تكون null).
مثال: null

items.distance: number
مسافة الصلة (الدلالية) للبحث. تظهر فقط في نتائج البحث الدلالي.
مثال: 0.42

items.discountConfig: Record<string, unknown>
كائن تكوين الخصم.
مثال:

{}

items.templateIdentifier: string | null
معرف المستخدم للقالب المرتبط.
مثال: "template_12345"

items.shortDescTemplateIdentifier: string | null
معرف المستخدم للقالب المرتبط للوصف القصير.
مثال: "short_desc_template_12345"

items.signedPrice: string
السعر الموقّع للمنتج يتم الحصول عليه مع بيانات المنتج عند تعيين signPrice.
انظر: سعر المنتج الثابت
مثال: "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

items.productPages: IProductPageRef[]
مصفوفة من مراجع صفحات المنتجات تربط المنتج بصفحاتها.
مثال:

[
  {
    "id": 16,
    "pageId": 4,
    "productId": 15,
    "positionId": 244,
    "categoryPath": "products"
  }
]

items.blocks: string[]
مصفوفة من معرفات الكتل.
مثال:

[
  "block_12345",
  "block_67890"
]

totalFound: number
عدد المنتجات المطابقة قبل تطبيق الحدود؛ يتم إرجاعه من نقاط نهاية منتجات الكتل (similarProducts، توصيات عربة التسوق/قائمة الرغبات، الطلبات المتكررة). اختياري.
مثال: 2

🔒 signedPrice هو الرمز الموقّع الذي يحمل السعر المقفل — قم بإعادته عند إنشاء طلب. انظر سعر المنتج الثابت (signedPrice).

---