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

getProductsCountByPageUrl

ابحث عن جميع كائنات المنتجات مع الترقيم للنوع المحدد (حسب عنوان URL الخاص به).

الوصف

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

Products.getProductsCountByPageUrl( url, body );

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

المخطط

url(مطلوب): string
عنوان URL للصفحة

body(مطلوب): any[]
معلمات الجسم للتصفية. الافتراضي: []
مثال:

[
{
"attributeMarker": "price",
"conditionMarker": "in",
"statusMarker": "status_1",
"conditionValue": {},
"pageUrls": [
"23-laminat-floorwood-maxima"
],
"title": "Iphone 17 Pro"
}
]

أمثلة

جربها مباشرة

قم بتشغيل هذه الطريقة بشكل تفاعلي في JS SDK sandbox — قم بتوصيل عنوان URL لمشروعك ورمز التطبيق في الزيارة الأولى، ثم افتح:


مثال بسيط

const response = await Products.getProductsCountByPageUrl('catalog');
استخدم الفلاتر للعثور على منتجات محددة:

attributeMarker: المعرف النصي للخاصية المفهرسة التي يتم تصفية القيم بناءً عليها. conditionMarker: نوع الشرط الذي سيتم تطبيقه على قيمة الخاصية.

Markerالمعنىالمثال
eqيساويstatusId = 1 (نشط فقط)
neqلا يساويcategory ≠ "أرشيف"
inيحتوي على (واحد من)category in ["إلكترونيات", "كتب"]
ninلا يحتوي علىbrand not in ["علامة_زائفة"]
exsموجود (له قيمة)لديه وصف
nexsغير موجودلا توجد صورة

conditionValue: القيمة التي سيتم المقارنة بها.

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

{
"totalAll": 3,
"totalInCategory": 3,
"totalInCategoryWithNested": 3
}

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

المخطط: IProductsCount

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

totalInCategory: number
إجمالي عدد المنتجات الموجودة في الفئة.
مثال: 50

totalInCategoryWithNested: number
إجمالي عدد المنتجات الموجودة في الفئة المتداخلة.
مثال: 10