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

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

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

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

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

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

المخطط: IProductsCount

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

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

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

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

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

جربه مباشرة​

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