getProductsCount

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

الوصف

يحسب عدد المنتجات التي تطابق شروط التصفية في body. يُعيد IProductsCount يحتوي على totalAll وtotalInCategory وtotalInCategoryWithNested.

.getProductsCount( );

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

المخطط

body: any[]
كائنات التصفية مع شروط البحث. الافتراضي: [].
مثال:

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

أمثلة

مثال بسيط

  const response = await Products.getProductsCount();

مثال مع الفلاتر

const response = await Products.getProductsCount([
  { attributeMarker: 'price', conditionMarker: 'mth', conditionValue: 100 },
]);

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

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

Marker	المعنى	مثال
eq	يساوي	color = "red"
neq	لا يساوي	category ≠ "أرشيف"
in	يحتوي (مطابقة سلسلة فرعية غير حساسة لحالة الأحرف)	brand يحتوي على "app"
nin	لا يحتوي (مطابقة سلسلة فرعية غير حساسة لحالة الأحرف)	brand لا يحتوي على "fake"
mth	أكبر من	price > 100
lth	أقل من	price < 50
exs	موجود (له قيمة)	لديه وصف
nexs	غير موجود	لا توجد صورة
pat	يطابق نمط تعبير نمطي حيث يمثّل كل * حرفًا واحدًا بالضبط و_ مسافة. عند تفعيل فهرسة البحث، يجب أن يطابق النمط القيمة كاملة	currency يطابق "s" (يعثر على "usd")
same	له القيمة نفسها لمنتج آخر واحد على الأقل. يُتجاهل conditionValue	المنتجات التي تشترك في السعر
same_part	له القيمة نفسها لمنتج آخر بعد قطع المقاطع الأخيرة. conditionValue بالصيغة delimiter|count (الافتراضي -|2)؛ وتُقارَن القيمة التي لها count مقاطع أو أقل كاملةً	رمزا SKU "ABC-1-S" و"ABC-1-M" يشتركان في "ABC"

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

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

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

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

المخطط: IProductsCount

totalAll: number
عدد المنتجات المرئية المطابقة في الكتالوج بأكمله، على أي صفحة.
مثال: 100

totalInCategory: number
عدد المنتجات المطابقة على صفحة الكتالوج نفسها. دائمًا 0 لـ getProductsCount، التي لا صفحة لها.
مثال: 50

totalInCategoryWithNested: number
عدد المنتجات المطابقة على صفحة الكتالوج وفئاتها المتداخلة. دائمًا 0 لـ getProductsCount، التي لا صفحة لها.
مثال: 10

---

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

شرح تفصيلي خطوة بخطوة في الوثائق:

• الحصول على عدد المنتجات: الحصول على العدد الإجمالي للمنتجات، مع تصفية اختيارية.

جربها مباشرة

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

• الحصول على عدد المنتجات: الحصول على العدد الإجمالي للمنتجات، مع تصفية اختيارية.