انتقل إلى المحتوى الرئيسي

getProductsByPageId

ابحث عن جميع كائنات المنتجات مع الترقيم لفئة محددة

Products.getProductsByPageId(id, body, langCode, userQuery)

const body = [
{
"attributeMarker": "price",
"conditionMarker": "mth",
"statusMarker": "waiting",
"conditionValue": 1,
"pageUrls": [
"23-laminat-floorwood-maxima"
],
"isNested": false,
"title": ""
},
{
"attributeMarker": "price",
"conditionMarker": "lth",
"conditionValue": 3,
"pageUrls": [
"23-laminat-floorwood-maxima"
],
"isNested": false,
"title": ""
}
];

const value = await Products.getProductsByPageId(1764, body);
Schema

id:* رقم
معرف الصفحة
مثال: 1

body: IFilterParams[]
جسم الطلب
مثال: []

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

userQuery: IProductsQuery
معلمات استعلام اختيارية.
مثال:

userQuery.offset: رقم
معامل اختياري للترقيم، الافتراضي هو 0
مثال: 0

userQuery.limit: رقم
معامل اختياري للترقيم، الافتراضي هو 30
مثال: 30

userQuery.statusMarker: سلسلة
معرف اختياري لحالة صفحة المنتج
مثال: waiting

userQuery.conditionValue: سلسلة
قيمة اختيارية يتم البحث عنها
مثال: 1

userQuery.conditionMarker: سلسلة
معرف اختياري لشرط الفلتر الذي يتم من خلاله تصفية القيم
مثال: mth

userQuery.attributeMarker: سلسلة
معرف نصي اختياري للخاصية المفهرسة التي يتم من خلالها تصفية القيم
مثال: price

userQuery.sortOrder: سلسلة
ترتيب الفرز الاختياري DESC | ASC
مثال: DESC

userQuery.sortKey: سلسلة
حقل اختياري للفرز (id، title، date، price، position، status)
مثال: id


Schema (body)

attributeMarker: سلسلة
معرف نصي للخاصية
مثال: price

conditionMarker: سلسلة
معرف نصي للشرط
مثال: in

statusMarker: سلسلة
معرف نصي لحالة صفحة المنتج (الافتراضي غير محدد)
مثال: status_1

conditionValue: رقم
قيمة الشرط
مثال: 1

pageUrls: Array<string>
جزء فريد من عنوان URL للصفحة (بعد آخر "/")

title: سلسلة
مثال: Iphone 17 Pro
اسم المنتج

isNested: بولياني
مؤشر البحث لجميع الفئات المتداخلة (pageUrls)
مثال: false

تبحث هذه الطريقة عن جميع كائنات المنتجات مع الترقيم لفئة محددة، بناءً على معلمات الاستعلام المقدمة (userQuery). تعيد Promise التي تحل إلى مصفوفة من العناصر، حيث كل عنصر هو كائن.

مثال على الإرجاع:

{
"total": 100,
"items": [
{
"id": 2,
"localizeInfos": {
"title": "Box"
},
"statusIdentifier": "sold",
"statusLocalizeInfos": {
"title": "Sold"
},
"attributeSetIdentifier": "products",
"position": 3,
"templateIdentifier": null,
"isPositionLocked": false,
"shortDescTemplateIdentifier": null,
"price": 148,
"additional": {
"prices": {
"min": 120,
"max": 150
}
},
"sku": null,
"isSync": true,
"attributeValues": {
"price": {
"type": "integer",
"value": 148,
"position": 1,
"isProductPreview": false
},
"product-name": {
"type": "string",
"value": "Box text",
"position": 0,
"isProductPreview": false
},
"currency_products": {
"type": "string",
"value": "$",
"position": 2,
"isProductPreview": false
}
},
"isVisible": true,
"isPositionLocked": false
}
]

}
Schema

total: رقم
إجمالي عدد السجلات التي تم العثور عليها
مثال: 100

id: رقم
معرف الكائن
مثال: 1764

additional: Record<string, any>
قيمة إضافية من الفهرس
مثال:

{
"prices": {
"min": 0,
"max": 100
}
}

statusLocalizeInfos: CommonLocalizeInfos
وصف json لكائن حالة العنصر، مع الأخذ في الاعتبار اللغة
مثال:

{ "title": "Product" }

localizeInfos: Record<string, any>
وصف json لكائن بيانات الصفحة الرئيسية مع الأخذ في الاعتبار اللغة "en_US" (على سبيل المثال)
مثال:

{
"en_US": {
"title": "Catalog",
"plainContent": "Content for catalog",
"htmlContent": "<b>Content for catalog</b>",
"menuTitle": "Catalog"
}
}

isVisible: بولياني
علامة رؤية الصفحة
مثال: true

position: رقم
رقم الموضع (للتصنيف)
مثال: 192

templateIdentifier: سلسلة
معرف مخصص للقالب المرتبط
مثال: my-template

attributeSetId: رقم
معرف مجموعة الخصائص
مثال: 7

blocks: مصفوفة
كتل المنتج
مثال: ['product_block']

isSync: بولياني
مؤشر فهرسة الصفحة (true أو false)
مثال: false

attributeValues: Record<string, string>
مصفوفة من قيم الخصائص من الفهرس (مقدمة كزوج من معرف الخاصية المخصص: قيمة الخاصية)
مثال:

{
"en_US": {
"marker": {
"value": "",
"type": "string"
}
}
}

statusId: رقم
معرفات حالة صفحة المنتج (يمكن أن تكون null)
مثال: 1

sku: سلسلة
قيمة SKU للمنتج مأخوذة من الفهرس
مثال: 1

relatedIds: مصفوفة
معرفات صفحات المنتجات ذات الصلة
مثال:

[ 1, 2, 3 ]

price: رقم
قيمة سعر صفحة المنتج مأخوذة من الفهرس
مثال: 0

templateIdentifier سلسلة
معرف مخصص للقالب المرتبط
مثال: my-template

shortDescTemplateIdentifier سلسلة
معرف مخصص للقالب المرتبط للوصف القصير
مثال: my-template-short