getProductsCount
Obtenir le nombre de tous les produits, avec des filtres facultatifs.
Description
Compte les produits qui correspondent aux conditions de filtre de body. Renvoie un IProductsCount avec totalAll, totalInCategory et totalInCategoryWithNested.
.getProductsCount(
);
Schéma des paramètres
Schema
body: any[]
Objets de filtre avec des conditions de recherche. Par défaut : [].
exemple :
[
{
"attributeMarker": "price",
"conditionMarker": "in",
"statusMarker": "status_1",
"conditionValue": {},
"pageUrls": [
"23-laminat-floorwood-maxima"
],
"title": "Iphone 17 Pro"
}
]
Exemples
Exemple minimal
const response = await Products.getProductsCount();
Exemple avec des filtres
const response = await Products.getProductsCount([
{ attributeMarker: 'price', conditionMarker: 'mth', conditionValue: 100 },
]);
Utilisez des filtres pour obtenir le nombre de produits précis :
attributeMarker : L'identifiant textuel de l'attribut indexé par lequel les valeurs sont filtrées. conditionMarker : Le type de condition à appliquer à la valeur de l'attribut.
| Marqueur | Signification | Exemple |
|---|---|---|
| eq | Égal | color = "red" |
| neq | Pas égal | category ≠ "archivé" |
| in | Contient (sous-chaîne, insensible à la casse) | brand contient "app" |
| nin | Ne contient pas (sous-chaîne, insensible à la casse) | brand ne contient pas "fake" |
| mth | Supérieur à | price > 100 |
| lth | Moins que | price < 50 |
| exs | Existe (a une valeur) | A une description |
| nexs | N'existe pas | Pas d'image |
| pat | Correspond à un motif d'expression régulière où chaque * représente exactement un caractère et _ un espace. Avec l'indexation de recherche activée, le motif doit correspondre à la valeur entière | currency correspond à "s" (trouve "usd") |
| same | A la même valeur qu'au moins un autre produit. conditionValue est ignoré | produits ayant le même prix |
| same_part | A la même valeur qu'un autre produit une fois les derniers segments retirés. conditionValue vaut delimiter|count (par défaut -|2) ; une valeur comptant count segments ou moins est comparée en entier | les SKU "ABC-1-S" et "ABC-1-M" partagent "ABC" |
conditionValue : La valeur à comparer.
Exemple de réponse
{
"totalAll": 6,
"totalInCategory": 0,
"totalInCategoryWithNested": 0
}
Schéma de réponse
Schéma : IProductsCount
totalAll: number
Nombre de produits visibles correspondants dans tout le catalogue, sur n'importe quelle page.
exemple : 100
totalInCategory: number
Nombre de produits correspondants sur la page de catalogue elle-même. Toujours 0 pour getProductsCount, qui n'a pas de page.
exemple : 50
totalInCategoryWithNested: number
Nombre de produits correspondants sur la page de catalogue et ses catégories imbriquées. Toujours 0 pour getProductsCount, qui n'a pas de page.
exemple : 10
Exemples d'utilisation
Tutoriel pas à pas dans la documentation :
- Get products count : obtenir le nombre total de produits, éventuellement filtrés.
Essayer en direct
Exécutez cette méthode dans le bac à sable JS SDK. Lors de votre première visite, connectez l'URL de votre projet et votre App Token, puis ouvrez :
- Get products count : obtenir le nombre total de produits, éventuellement filtrés.