Envoyer des mises à jour de produits

Pour envoyer des mises à jour de produits, utilisez le point de terminaison /{catalog_id}/items_batch.

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

https://graph.facebook.com/<API_VERSION>/<CATALOG_ID>/items_batch?requests=<REQUESTS>
Paramètre Type Description

allow_upsert

booléen

Facultatif : définissez cette valeur sur true si vous souhaitez empêcher les demandes de mise à jour de créer de nouveaux articles.

Lorsque la valeur est définie sur 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.

item_type

énumération

Type d’articles dans la demande. Valeurs : DESTINATION, FLIGHT, HOME_LISTING, HOTEL, HOTEL_ROOM, PRODUCT_ITEM, VEHICLE, VEHICLE OFFER.

requests

objet

Objet JSON contenant toutes les demandes.

requests.data

objet

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

  • Lorsque la méthode est CREATE, cet objet doit contenir tous les champs requis pour le item_type spécifié.
  • 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

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

Limites

  • Le paramètre requests peut contenir jusqu’à 5 000 articles.
  • Pour chaque catalogue, vous êtes limité·e à un certain nombre d’appels par heure, défini par la formule de plafond du cas d’utilisation pour les entreprises de Catalog Batch. Si ce nombre est insuffisant, veuillez nous contacter.
  • 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 les champs pris en charge pour le point de terminaison /{catalog_id}/items_batch :