getProductsCountByPageId
Obtener el número de productos de una página del catálogo por ID de página.
Descripción
Cuenta los productos de la página del catálogo con el id indicado, opcionalmente filtrados por las condiciones de body, y se resuelve en un IProductsCount.
.getProductsCountByPageId(
,
);
Esquema de parámetros
Esquema
id(required): number | string
ID de la página.
ejemplo: 12345
body: any[]
Objetos de filtro con condiciones de búsqueda. Predeterminado: [].
ejemplo:
[
{
"attributeMarker": "price",
"conditionMarker": "in",
"statusMarker": "status_1",
"conditionValue": {},
"pageUrls": [
"23-laminat-floorwood-maxima"
],
"title": "Iphone 17 Pro"
}
]
Ejemplos
Ejemplo mínimo
const response = await Products.getProductsCountByPageId(10);
Ejemplo con filtros
const response = await Products.getProductsCountByPageId(10, [
{ attributeMarker: 'price', conditionMarker: 'mth', conditionValue: 100 },
]);
Usa filtros para obtener el recuento de productos concretos:
attributeMarker: El identificador de texto del atributo indexado por el cual se filtran los valores. conditionMarker: El tipo de condición que se aplica al valor del atributo.
| Marcador | Significado | Ejemplo |
|---|---|---|
| eq | Igual | color = "red" |
| neq | No igual | categoría ≠ "archivado" |
| in | Contiene (coincidencia de subcadena sin distinguir mayúsculas de minúsculas) | brand contiene "app" |
| nin | No contiene (coincidencia de subcadena sin distinguir mayúsculas de minúsculas) | brand no contiene "fake" |
| mth | Mayor que | price > 100 |
| lth | Menor que | price < 50 |
| exs | Existe (tiene valor) | Tiene descripción |
| nexs | No existe | Sin imagen |
| pat | Coincide con un patrón de expresión regular en el que cada * equivale exactamente a un carácter y _ a un espacio. Con la indexación de búsqueda activada, el patrón debe coincidir con el valor completo | currency coincide con "s" (encuentra "usd") |
| same | Tiene el mismo valor que al menos otro producto. conditionValue se ignora | productos que comparten precio |
| same_part | Tiene el mismo valor que otro producto tras cortar los últimos segmentos. conditionValue es delimiter|count (predeterminado -|2); un valor con count segmentos o menos se compara completo | los SKU "ABC-1-S" y "ABC-1-M" comparten "ABC" |
conditionValue: El valor con el que comparar.
Ejemplo de respuesta
{
"totalAll": 6,
"totalInCategory": 6,
"totalInCategoryWithNested": 6
}
Esquema de respuesta
Esquema: IProductsCount
totalAll: number
Número de productos visibles coincidentes en todo el catálogo, en cualquier página.
ejemplo: 100
totalInCategory: number
Número de productos coincidentes en la propia página de catálogo. Siempre 0 en getProductsCount, que no tiene página.
ejemplo: 50
totalInCategoryWithNested: number
Número de productos coincidentes en la página de catálogo y sus categorías anidadas. Siempre 0 en getProductsCount, que no tiene página.
ejemplo: 10