Catalogue

Envoyer des mises à jour d’articles

Pour envoyer des mises à jour d’articles, utilisez le point de terminaison /{catalog_id}/batch.

Pour créer, mettre à jour ou supprimer des articles dans votre catalogue, effectuez un appel HTTP POST vers :

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/batch?requests=<REQUESTS>

Paramètres

Les noms de paramètres pour /{catalog_id}/batch et /{catalog_id}/items_batch peuvent sembler similaires, mais ils sont distinctement différents.

Nous recommandons d’utiliser l’API /{catalog_id}/items_batch, qui prend en charge davantage de cas d’utilisation et est maintenue de manière active.

Paramètre Type Description

allow_upsert

booléen

Lorsque allow_upsert indique false, les demandes de mise à jour des articles qui ne figurent pas dans le catalogue ne sont pas exécutées. Sinon, de nouveaux articles sont créés.

requests

objet

Objet JSON contenant toutes les demandes.

requests.data

objet

Objet JSON contenant des champs et des valeurs pour un article.

  • Lorsque la méthode est CREATE, cet objet doit contenir tous les champs obligatoires.
  • Lorsque la méthode est UPDATE, l’objet peut contenir n’importe quel champ.

Remarque : consultez les champs pris en charge qui peuvent être transmis.

requests.method

chaîne

CREATE, UPDATE, DELETE

requests.retailer_id

chaîne

id d’un élément fourni par l’annonceur ; différent du FBID.

Il est également possible d’avoir recours à la méthode UPDATE pour créer des éléments s’ils n’existent pas encore.

Pour plus de détails, consultez la référence sur l’API.

Limites

  • Le paramètre requests peut contenir jusqu’à 5 000 mises à jour.
  • Pour chaque catalogue, vous êtes limité à un certain nombre d’appels par heure, défini par la formule du plafond du cas d’utilisation pour les entreprises de Catalog Batch. Si ce nombre est insuffisant, veuillez nous contacter.
  • La taille limite des lots est de 5 000.
  • Le code d’erreur 1 associé au message "Please reduce the amount of data you're asking for, then retry your request" indique que la taille des données (en octets) reçues dans la requête d’API est trop importante. Pour corriger ce problème, réduisez le nombre d’éléments inclus dans le lot, puis réessayez. Ainsi, la requête respectera les limites de taille acceptable et pourra être traitée correctement.

Champs pris en charge

Consultez la liste des champs pris en charge pour le point de terminaison /{catalog_id}/batch.

En savoir plus