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"
}
]
أمثلة
جربها مباشرة
قم بتشغيل هذه الطريقة بشكل تفاعلي في JS SDK sandbox — قم بتوصيل عنوان URL لمشروعك ورمز التطبيق في الزيارة الأولى، ثم افتح:
- احصل على عدد المنتجات حسب الصفحة — احصل على إجمالي عدد المنتجات في صفحة كتالوج معينة، مفيد للترقيم.
مثال بسيط
const response = await Products.getProductsCountByPageUrl('catalog');
استخدم الفلاتر للعثور على منتجات محددة:
attributeMarker: المعرف النصي للخاصية المفهرسة التي يتم تصفية القيم بناءً عليها. conditionMarker: نوع الشرط الذي سيتم تطبيقه على قيمة الخاصية.
| Marker | المعنى | المثال |
|---|---|---|
| eq | يساوي | statusId = 1 (نشط فقط) |
| neq | لا يساوي | category ≠ "أرشيف" |
| in | يحتوي على (واحد من) | category in ["إلكترونيات", "كتب"] |
| nin | لا يحتوي على | brand not in ["علامة_زائفة"] |
| exs | موجود (له قيمة) | لديه وصف |
| nexs | غير موجود | لا توجد صورة |
conditionValue: القيمة التي سيتم المقارنة بها.
مثال على الاستجابة
{
"totalAll": 3,
"totalInCategory": 3,
"totalInCategoryWithNested": 3
}
مخطط الاستجابة
المخطط: IProductsCount
totalAll: number
إجمالي عدد المنتجات الموجودة.
مثال: 100
totalInCategory: number
إجمالي عدد المنتجات الموجودة في الفئة.
مثال: 50
totalInCategoryWithNested: number
إجمالي عدد المنتجات الموجودة في الفئة المتداخلة.
مثال: 10