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"
  }
]

أمثلة

مثال بسيط

  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	غير موجود	لا توجد صورة
pat	يتطابق مع النمط	title matches "جاكيت"
same	يتطابق مع القيمة بالضبط	sku هو بالضبط "ABC-123"
same_part	يتطابق مع جزء من القيمة بالضبط	جزء من sku هو بالضبط "ABC"

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

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

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

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

المخطط: IProductsCount

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

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

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

---

أمثلة الاستخدام

خطوة بخطوة في الوثائق:

• احصل على عدد المنتجات — احصل على العدد الإجمالي للمنتجات، مع إمكانية الفلترة.

جربه مباشرة

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

• احصل على عدد المنتجات — احصل على العدد الإجمالي للمنتجات، مع إمكانية الفلترة.