Gestion du catalogue

​

Vue d’ensemble

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

Un catalogue regroupe tout ce qui concerne les produits et ensembles de produits d’un utilisateur et 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 méthodes d’importation de 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 par lots (JSON)

Les marchands X peuvent créer des ensembles de produits à partir de règles de filtrage. Ce faisant, ils peuvent associer des métadonnées supplémentaires à leurs produits et créer des ensembles spécifiques pour mettre en avant ces produits via des fonctionnalités de commerce organique ou des publicités dynamiques pour produits. L’API Catalog et le gestionnaire d’achats X 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 répondent à ces filtres. Les types de filtres incluent le prix, la catégorie de produit Google, le type de produit, l’inventaire, le prix promotionnel et les champs personnalisés.

L’API Catalog propose 4 endpoints pour gérer le catalogue :

• 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 - Regroupement des produits en ensembles sur la base des informations produit
• Scheduled Feeds - Configuration de l’importation asynchrone de données produit basées sur des fichiers dans les catalogues

​

Prérequis pour l’API Catalog

Les endpoints de l’API Catalog sont actuellement disponibles uniquement dans le cadre d’un 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 d’informations sur 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 endpoint.

​

Catalogue de produits

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

​

API Produits en lot

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

​

Ensembles de produits

Méthode HTTP	Limite de taux
GET /product_catalogs/:product_catalog_id/product_sets	2 000 par 15 minutes
POST /product_catalogs/:product_catalog_id/product_sets	100 par 15 minutes
PUT /product_catalogs/:product_catalog_id/product_sets/:product_set_id	500 par 15 minutes
DELETE /product_catalogs/:product_catalog_id/product_sets/:product_set_id	100 par 15 minutes

​

Flux produits

Méthode HTTP	Limite de taux
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