getProductsCountByPageUrl
Obtenir le nombre de produits d'une page de catalogue par l'URL de la page.
Description
Compte les produits de la page de catalogue avec l'url indiquée, éventuellement filtrés par les conditions de body, et renvoie un IProductsCount.
.getProductsCountByPageUrl(
,
);
Schéma des paramètres
Schema
url(required): string
URL de la page.
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.getProductsCountByPageUrl('catalog');
Exemple avec des filtres
const response = await Products.getProductsCountByPageUrl('catalog', [
{ attributeMarker: 'price', conditionMarker: 'mth', conditionValue: 100 },
]);
Utilisez des filtres pour trouver des 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 | Inférieur à | 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": 6,
"totalInCategoryWithNested": 6
}
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 by page : obtenir le nombre total de produits d'une page de catalogue donnée, utile pour la pagination.
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 by page : obtenir le nombre total de produits d'une page de catalogue donnée, utile pour la pagination.