Gestion du catalogue

​

Vue d’ensemble

L’API Catalog est une solution de commerce qui donne aux annonceurs la possibilité de configurer des flux de produits, de regrouper des produits en ensembles et de gérer de façon centralisée les produits de leur catalogue. L’API Catalog sera un outil central qui permet la gestion programmatique des catalogues et donne aux annonceurs un meilleur contrôle sur la façon dont leurs catalogues sont importés et mis à jour.

Un catalogue contient tous les produits et ensembles de produits de l’utilisateur, et il est associé au handle de l’utilisateur. Actuellement, un utilisateur ne peut créer qu’un seul catalogue. 

L’API Catalog prend en charge 2 modes d’import des produits :

1. Scheduled Feed : l’utilisateur peut ajouter une URL de flux (CSV, TSV et XML) qui sera récupérée périodiquement (X prend actuellement en charge des fichiers jusqu’à 8 Go)

2. Batch Products API : l’utilisateur peut consulter, créer, mettre à jour et supprimer des attributs de produit avec des requêtes groupées (JSON)

Les marchands X peuvent créer des ensembles de produits à partir de règles de filtrage. Ce faisant, ils peuvent ajouter des métadonnées supplémentaires à leurs produits et créer des ensembles de produits spéciaux pour mettre ces produits en avant via des fonctionnalités de commerce organique ou des annonces de produits dynamiques. L’API Catalog et X Shopping Manager prennent en charge deux types d’ensembles de produits. 

1. Manuel : l’utilisateur peut sélectionner jusqu’à 50 produits et définir un nom et une description

2. Filtre : l’utilisateur peut ajouter jusqu’à 30 filtres pour générer automatiquement des ensembles contenant les produits qui satisfont ces filtres. Les types de filtres incluent le prix, la catégorie de produit Google, le type de produit, le stock, le prix promotionnel et les champs personnalisés.

L’API Catalog propose 4 endpoints pour gérer les catalogues :

• Product Catalogs - Création d’un conteneur pour les informations produit
• Products -  Ajout, mise à jour, consultation et suppression synchrones de produits dans les catalogues
• Product Sets -  Classement des produits en groupes en fonction des informations produit
• Schedule Feeds - Configuration de l’ingestion asynchrone de données produit à partir de fichiers dans les catalogues

​

Prérequis pour l’API Catalog

Les endpoints de l’API Catalog ne sont actuellement disponibles qu’en accès anticipé. Pour demander l’accès, veuillez contacter votre représentant X. 

Vous devez accepter les Conditions d’utilisation via X Shopping Manager.

Pour plus de détails sur X Shopping Manager et les spécifications des produits, veuillez consulter le guide des spécifications des produits.

​

Limites de taux

Le tableau suivant présente les limites de taux pour chaque point de terminaison.

​

Catalogue de produits

Méthode HTTP	Limite de débit
GET /product_catalogs	1 000 par période de 15 minutes
POST /product_catalogs	20 par période de 15 minutes
PUT /product_catalogs/:product_catalog_id	20 par période de 15 minutes
DELETE /product_catalogs/:product_catalog_id	20 par période de 15 minutes

​

API de produits en lot

Méthode HTTP	Limite de requêtes
GET /product_catalogs/:product_catalog_id/products	1 000 par tranche de 15 minutes
PUT /product_catalogs/:product_catalog_id/products	600 par tranche de 15 minutes
DELETE /product_catalogs/:product_catalog_id/products	150 par tranche de 15 minutes

​

Ensembles de produits

Méthode HTTP	Limite de requêtes
GET /product_catalogs/:product_catalog_id/product_sets	2 000 toutes les 15 minutes
POST /product_catalogs/:product_catalog_id/product_sets	100 toutes les 15 minutes
PUT /product_catalogs/:product_catalog_id/product_sets/:product_set_id	500 toutes les 15 minutes
DELETE /product_catalogs/:product_catalog_id/product_sets/:product_set_id	100 toutes les 15 minutes

​

Flux de produits

Méthode HTTP	Limite de débit
GET /product_catalogs/:product_catalog_id/product_feeds	1 000 par 15 minutes
POST /product_catalogs/:product_catalog_id/product_feeds	20 par 15 minutes
PUT /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id	20 par 15 minutes
DELETE /product_catalogs/:product_catalog_id/product_feeds/:product_feed_id	20 par 15 minutes