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

أمثلة

مثال بسيط

  const response = await Products.getProductsCountByPageUrl('catalog');

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

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

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

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

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

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

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

المخطط: IProductsCount

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

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

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

---

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

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

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

جربه مباشرة

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

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