getProductsCountByPageUrl

الحصول على عدد منتجات صفحة كتالوج بواسطة عنوان URL للصفحة.

الوصف

يحسب عدد المنتجات في صفحة الكتالوج ذات url المحدد، مع إمكانية التصفية حسب الشروط في body، ويُعيد IProductsCount.

.getProductsCountByPageUrl( , );

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

المخطط

url(مطلوب): string
رابط الصفحة.

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');

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

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

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

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

العلامة	المعنى	المثال
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": 6,
  "totalInCategoryWithNested": 6
}

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

المخطط: IProductsCount

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

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

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

---

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

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

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

جربها مباشرة

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

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