getProductsCount

احصل على عدد جميع المنتجات مع فلاتر اختيارية.

الوصف

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

Products.getProductsCount( body );

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

المخطط

body(required): 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.getProductsCount();

استخدم الفلاتر للعثور على عدد منتجات محددة:

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

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

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

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

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

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

المخطط: IProductsCount

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

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

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

---