getProductBlockById
احصل على كائنات ContentPageBlock بواسطة معرف المنتج.
الوصف
تقوم هذه الطريقة بالحصول على كائن كتلة المنتج بواسطة معرف المنتج. تعيد Promise التي تحل إلى مصفوفة من كائنات كتلة المنتج IProductBlock.
Products.getProductBlockById(
id*);
مخطط المعلمات
المخطط
id(مطلوب): number
معرف المنتج
مثال: 12345
أمثلة
مثال بسيط
const response = await Products.getProductBlockById(1764);
مثال على الاستجابة
[
{
"id": 1,
"attributeSetIdentifier": null,
"localizeInfos": {
"title": "Product Block"
},
"version": 0,
"position": 1,
"identifier": "product_block",
"type": "product_block",
"customSettings": {
"productConfig": {
"quantity": "1",
"sortType": 0,
"sortOrder": 0,
"countElementsPerRow": "1"
},
"similarProductRules": [],
"condition": {
"name": "cost",
"costTo": 130,
"costFrom": 0
},
"sliderDelay": null,
"sliderDelayType": null
},
"templateIdentifier": null,
"isVisible": true,
"isSync": false,
"attributeValues": {}
}
]
مخطط الاستجابة
المخطط: IProductBlock
id: number
معرف فريد لكتلة المنتج.
مثال: 3289
attributeSetIdentifier: string | null
معرف مجموعة السمات المستخدمة في كتلة المنتج، أو null إذا لم يكن ذلك قابلاً للتطبيق.
مثال: "product_block"
localizeInfos: ILocalizeInfo
معلومات التوطين لكتلة المنتج.
مثال:
{
"title": "Box"
}
version: number
إصدار كيان كتلة المنتج.
مثال: 1
position: number
موضع كتلة المنتج في قائمة أو تخطيط.
مثال: 1
identifier: string
معرف سلسلة فريد لكتلة المنتج.
مثال: "product_block_12345"
type: Types
نوع كتلة المنتج، مثل "منتج"، "صفحة خطأ"، إلخ.
مثال: "product"
customSettings: object
إعدادات مخصصة لكتلة المنتج، بما في ذلك تأخير الشريط، تكوين المنتج، قواعد المنتجات المماثلة، والشروط.
مثال:
templateIdentifier: string | null
معرف القالب المستخدم بواسطة كتلة المنتج، أو null إذا لم يكن ذلك قابلاً للتطبيق.
مثال: "template_12345"
isVisible: boolean
تشير إلى ما إذا كانت كتلة المنتج مرئية.
مثال: true
isSync: boolean
تشير إلى ما إذا كانت كتلة المنتج متزامنة.
مثال: false
attributeValues: AttributeType
مصفوفة من قيم السمات من الفهرس، ممثلة كزوج من معرف سمة المستخدم وقيمة السمة.
مثال:
[
{
"id": "color",
"value": "red"
}
]
sliderDelay: number | null
تأخير التقدم التلقائي للشريط.
مثال: 5000
sliderDelayType: string | null
وحدة sliderDelay (مثل "مللي ثانية"، "ثانية").
مثال: "مللي ثانية"
productConfig: IProductBlockProductConfig
تكوين التخطيط للمنتجات داخل الكتلة.
productConfig.quantity: string | number
عدد المنتجات التي سيتم عرضها.
مثال: 9
productConfig.countElementsPerRow: string | number
المنتجات في كل صف.
مثال: 3
productConfig.sortType: string | number
حقل الفرز.
مثال: "السعر"
productConfig.sortOrder: string | number
اتجاه الفرز.
مثال: "تصاعدي"
similarProductRules: IProductBlockSimilarRule[]
القواعد المستخدمة للعثور على المنتجات المماثلة.
similarProductRules.property: string
خاصية المنتج التي يجب مطابقتها.
مثال: "الفئات"
similarProductRules.includes: string
استراتيجية المطابقة (مثل "أي"، "جميع").
مثال: "أي"
similarProductRules.keywords: string
الكلمات الرئيسية المستخدمة للمطابقة.
مثال: "foo,bar"
similarProductRules.strict: string
علامة الصرامة ("صحيح"/"خطأ") للمطابقة.
مثال: "خطأ"
condition: Record<string, unknown>
شرط التصفية المطبق على المنتجات في الكتلة؛ يختلف حقل المجموعة حسب نوع الشرط (مثل { name: "cost", costFrom: 0, costTo: 130 }).
frequentlyOrderedConfig: Record<string, unknown> | null
تكوين ميزة المنتجات التي يتم طلبها بشكل متكرر، أو null عند عدم التكوين.
quantity: string | number
عدد المنتجات التي سيتم عرضها.
مثال: 9
countElementsPerRow: string | number
المنتجات في كل صف.
مثال: 3
sortType: string | number
حقل الفرز.
مثال: "السعر"
sortOrder: string | number
اتجاه الفرز.
مثال: "تصاعدي"
property: string
خاصية المنتج التي يجب مطابقتها.
مثال: "الفئات"
includes: string
استراتيجية المطابقة (مثل "أي"، "جميع").
مثال: "أي"
keywords: string
الكلمات الرئيسية المستخدمة للمطابقة.
مثال: "foo,bar"
strict: string
علامة الصرامة ("صحيح"/"خطأ") للمطابقة.
مثال: "خطأ"