3 mars 2022

Modifications non associées à une version.

API Marketing

Ensembles de produits

Modifications apportées aux filtres de recherche du catalogue

Depuis le 3 mars 2022, nous avons modifié la manière dont certains filtres se comportent pour créer des ensembles de produits dans votre catalogue. Ces modifications ont une incidence sur les types d’articles ajoutés à un ensemble de produits à sa création.

Calendrier
Le comportement des champs et des opérateurs changera dans 90 jours. Si un ensemble de votre catalogue utilise les filtres concernés après le 1er juin 2022, les articles qu’il contient sont susceptibles d’être modifiés. Cela signifie que d’autres articles pourraient apparaître dans vos publicités ou vos boutiques qui utilisent ces ensembles. De plus, les requêtes utilisant les filtres pourraient retourner un ensemble différent d’articles.

Vous trouverez de plus amples informations sur les filtres d’ensembles de produits sur cette page.

Opérateurs concernés par les modifications

Opérateur	Modification
`contains` / `not_contains`	La requête doit désormais correspondre à un mot entier, et non partiel. Par exemple, `name: {"contains": "red car"}` retourne tous les produits contenant ces deux mots, tels que « red car » et « red fast car », mais pas « red carpet ». Les mots comprenant des traits d’union sont considérés comme étant composés de plusieurs mots. Par exemple, si vous recherchez `name: {"contains": "shirt"}`, « shirt » et « T-shirt » seront tous les deux retournés. Chaque mot de votre requête doit apparaître dans le champ avec lequel vous souhaitez établir une correspondance, mais pas forcément dans l’ordre. Par exemple, la requête `name: {"contains": "jeans blue"}` retourne « blue cropped jeans », mais pas uniquement « jeans » ou « blue ».
`lt`	Cette option de filtrage n’est plus disponible pour les champs `custom_label`.
`lte`	Cette option de filtrage n’est plus disponible pour les champs `custom_label`
`gt`	Cette option de filtrage n’est plus disponible pour les champs `custom_label`
`gte`	Cette option de filtrage n’est plus disponible pour les champs `custom_label`
`starts_with`	Cette option de filtrage est maintenant uniquement disponible pour le champ Catégorie de produits. Pour les autres champs, utilisez le filtre `contains`.

Champs concernés par les modifications

Champ	Description
`custom_label_0`	La valeur de l’étiquette personnalisée d’un article, d’un hôtel, d’une destination, d’un véhicule ou d’une annonce immobilière. La valeur est traitée en tant que chaîne. Les opérateurs numériques (`gt`, `gte`, `lt`, `lte`) ne sont pas disponibles dans ce champ. Utilisez à la place le champ `custom_number_0 field`, qui prend en charge les entiers.
`custom_label_1`	La valeur de l’étiquette personnalisée d’un article, d’un hôtel, d’une destination, d’un véhicule ou d’une annonce immobilière. La valeur est traitée en tant que chaîne. Les opérateurs numériques (`gt`, `gte`, `lt`, `lte`) ne sont pas disponibles dans ce champ. Utilisez à la place le champ `custom_number_1` qui prend en charge les entiers.
`custom_label_2`	La valeur de l’étiquette personnalisée d’un article, d’un hôtel, d’une destination, d’un véhicule ou d’une annonce immobilière. La valeur est traitée en tant que chaîne. Les opérateurs numériques (`gt`, `gte`, `lt`, `lte`) ne sont pas disponibles dans ce champ. Utilisez à la place le champ `custom_number_2`, qui prend en charge les entiers.
`custom_label_3`	La valeur de l’étiquette personnalisée d’un article, d’un hôtel, d’une destination, d’un véhicule ou d’une annonce immobilière. La valeur est traitée en tant que chaîne. Les opérateurs numériques (`gt`, `gte`, `lt`, `lte`) ne sont pas disponibles dans ce champ. Utilisez à la place le champ `custom_number_3`, qui prend en charge les entiers.
`custom_label_4`	La valeur de l’étiquette personnalisée d’un article, d’un hôtel, d’une destination, d’un véhicule ou d’une annonce immobilière. La valeur est traitée en tant que chaîne. Les opérateurs numériques (`gt`, `gte`, `lt`, `lte`) ne sont pas disponibles dans ce champ. Utilisez à la place le champ `custom_number_4`, qui prend en charge les entiers.
`custom_number_0`	La valeur d’un entier personnalisé d’un article, d’un hôtel, d’une destination, d’un véhicule ou d’une annonce immobilière.
`custom_number_1`	La valeur d’un entier personnalisé d’un article, d’un hôtel, d’une destination, d’un véhicule ou d’une annonce immobilière.
`custom_number_2`	La valeur d’un entier personnalisé d’un article, d’un hôtel, d’une destination, d’un véhicule ou d’une annonce immobilière.
`custom_number_3`	La valeur d’un entier personnalisé d’un article, d’un hôtel, d’une destination, d’un véhicule ou d’une annonce immobilière.
`custom_number_4`	La valeur d’un entier personnalisé d’un article, d’un hôtel, d’une destination, d’un véhicule ou d’une annonce immobilière.

Pagination en fonction de repères

Le point de terminaison GET /{product-catalog-id}/products?filter=.....&offset=...&limit=...&bulk_pagination=false est désormais limité à 2 000 résultats.

Ce qui change

Actuellement, aucune limite n’est appliquée à la taille décalage + limite. À compter d’aujourd’hui, lorsque bulk_pagination = false, la taille décalage + limite ne peut pas être supérieure à 2 000. Par exemple :

décalage = 1 000, limite = 1 500 est impossible, car décalage + limite = 2 500
décalage = 100, limite = 1 500 est accepté, car décalage + limite = 1 600

Pour effectuer une pagination dans un catalogue sans limite, utilisez bulk_pagination = true.