Partenariats Marketplace

API Article pour les partenaires Marketplace

Votre statut de partenaire Marketplace permet à vos annonces d’apparaître sur Facebook Marketplace dans certains pays.

Pour importer, mettre à jour ou supprimer vos produits sur Facebook Marketplace, vous utiliserez l’interface de l’API Graph.

HTTP
POST /v20.0/{product-catalog-id}/items_batch HTTP/1.1

Si vous souhaitez apprendre à utiliser l’API Graph, consultez notre guide d’utilisation de l’API Graph.

Lorsque vous publiez sur cet edge, un article est créé.

Paramètres

Paramètre	Description
item_type	Définir comme PRODUCT_ITEM
requêtes	Méthode et champs pour chaque produit dans une gamme de produits.

Le paramètre de requête permet de définir la méthode et les données de votre requête.

Champ	Description
method	Action que vous souhaitez réaliser pour un produit donné. Options disponibles : CREATE UPDATE DELETE
données	Informations relatives au produit à créer, à mettre à jour ou à supprimer.

Exemples de paramètres de requête

[
    {
        "method": "CREATE",
        "data": {
            "id": "UniqueProductID",
            "title": "Title",
            "description": "This is the description",
            "price": "100 USD",
            "image_link": "https:\/\/www.facebook.com",
            "brand": "Monster",
            "availability": "in stock",
            "condition": "new",
            "link": "https:\/\/www.facebook.com",
            "return_details": {"return_days": "30", "return_type": "SELLER_PAID_RETURN"},
            "partner_product_checkout_uri": "https:\/\/www.facebook.com",
            "partner_product_location": "San Fransisco, CA",
            "partner_product_expiration_time": "1923181264",
            "partner_delivery_method": ["shipping"],
            "partner_shipping_type": "fixed",
            "partner_shipping_cost": "14.95",
            "partner_shipping_speed": "3:5",
            "partner_attribute_data": {"color": "blue"},
            "partner_seller_id": "MySellerId1",
            "partner_item_country": "US"
        }
    },
    .... {next product}
]

Plafond de l’API

Pour éviter une limitation de bande passante, suivez ces recommandations :

Ne dépassez pas 30 appels par minute, faute de quoi la bande passante sera limitée.
Regroupez les articles en un appel d’API (jusqu’à 300).

Champs relatifs aux articles

Paramètre	Type	Obligatoire/ facultatif	Description
`id`	Chaîne (nombre maximal de caractères : 100)	Requis	ID de contenu unique de l’article. Dans la mesure du possible, veuillez utiliser le SKU de l’article. Chaque ID de contenu ne doit figurer qu’une seule fois dans votre catalogue. S’il existe plusieurs occurrences du même ID, elles sont toutes ignorées. Si les articles sont disponibles dans plusieurs pays, vous devez réutiliser le même ID sur l’ensemble des catalogues. Assurez-vous de modifier le prix en fonction de la devise du pays (voir le champ Prix).
`title`	Chaîne (nombre maximal de caractères : 200)	Requis	Nom de l’article apparaissant sur l’annonce Marketplace. Ce texte apparaîtra sur Marketplace. N’ajoutez pas de balises HTML.
`description`	Chaîne (nombre maximal de caractères : 9 999)	Requis	Description du produit. Bien que la limite de ce champ soit fixée à 9 999 caractères, seuls les 256 premiers caractères seront visibles sur l’annonce Facebook Marketplace. Ce texte apparaîtra sur Marketplace. N’ajoutez pas de balises HTML. Exemple : T-shirt bleu roi confortable pour femme en coton bio. Manches courtes et coupe décontractée. Parfait pour les chaudes journées d’été.
`condition`	Enum {new, refurbished, used, used_like_new, used_good, used_fair, cpo, open_box_new}	Requis	État de l’article.
`partner_listing_type`	Enum {fixed_price, auction, vehicle, rental, real_estate}	Facultatif	Ceci détermine le type d’annonce. Il sera défini par défaut sur « fixed_price » s’il n’y a pas de sélection. S’il est défini comme « vente aux enchères », « véhicule », « véhicule de location » ou « immobilier », nous offrons une expérience de type d’annonce de partenaires spécifiée pour les acheteur·ses sur Marketplace.
`partner_product_condition`	Enum {acceptable, brand_new, certified_pre_owned, certified_refurbished, damaged, digital_good, excellent_refurbished, for_parts_or_not_working, good, good_refurbished, graded, like_new, new, new_other, new_other_see_details, new_with_box, new_with_defects, new_with_tags, open_box, others, pre_owned, remanufactured, retread, seller_refurbished, ungraded, used, very_good, very_good_refurbished, new_open_box, open_box_used, new_factory_sealed, unknown}	Facultatif	État du produit. Champ facultatif qui remplacera le champ « condition ». Utilisez-le si vous devez apporter des précisions sur l’état du produit.
`brand`	Chaîne	Requis	Marque du produit. Saisissez « N/A » s’il n’y a aucune marque à indiquer.
`price`	Chaîne (nombre maximal de caractères : 9 999)	Requis	Indiquez le prix en chiffres suivi d’une espace, puis ajoutez le code de devise ISO 4217 à trois lettres. Ex. : 10,99 EUR Si le type d’annonce est « enchère », il correspond au prix de l’enchère du produit. Indiquez le prix en chiffres suivi d’une espace, puis ajoutez le code de devise ISO 4217 à trois lettres.
`availability`	Enum {in stock, out of stock}	Requis	Disponibilité de l’article.
`link`	Chaîne	Requis	Lien Web URL mobile vers la page des informations produit.
`partner_product_checkout_uri`	Chaîne	Facultatif	Vérifiez le lien URL vers lequel l’utilisateur·ice est redirigé·e lorsqu’il appuie sur Acheter sur l’annonce. Nous ajouterons le click_id au paramètre. Si ce champ est vide, l’URL du champ « link » sera utilisée par défaut.
`partner_product_html_desc_uri`	Chaîne	Facultatif	Lien URL vers le site contenant la description complète du produit. Il est utilisé si la description du produit contient plus de caractères que la capacité du champ de texte « description ». Marketplace fournira éventuellement un lien vers la description complète.
`image_link`	Chaîne	Requis	URL de l’image principale de votre article. Les images doivent être au format JPEG ou PNG, contenir au moins 500 x 500 pixels et ne pas dépasser 8 Mo. Consultez les spécifications relatives aux images de produits.
`partner_seller_id`	Chaîne (nombre maximal de caractères : 100)	Requis	Identifiant unique du ou de la vendeur·se. Il doit correspondre au partner_seller_id dans les informations relatives à la vendeuse ou au vendeur. Exemple : “partner_seller_id”: “great_seller_inc”
`partner_item_country`	Enum {AT, BE, BG, CY, CZ, DE, DK, EE, ES, FI, FR, GR, HR, HU, IE, IS, IT, LI, LT, LU, LV, MT, NL, NO, PL, PT, RO, SE, SI, SK}	Requis	Pays dans lequel le produit est disponible et, le cas échéant, vers lequel il peut être expédié. Le pays du catalogue et le champ partner_item_country doivent correspondre. Pour les articles éligibles à l’expédition transfrontalière, il est nécessaire qu’un article soit créé dans chaque catalogue de pays où l’expédition est possible et où le partenaire a l’intention de vendre les articles.
`fb_product_category`	Chaîne	Facultatif	Catégorie de produit Facebook de l’article. Catégorie de produit Facebook la plus précise possible à partir de cette liste :Excel (.xls) ou Texte brut (.txt).
`status`	Enum {active, archived}	Facultatif	Statut actuel du produit.
`sale_price`	Chaîne	Facultatif	Indiquez le prix en chiffres suivi d’une espace, puis ajoutez le code de devise ISO 4217 à trois lettres. Ex. : 10,99 EUR Il s’agit du même format que pour le champ « price ». À utiliser avec le champ « price » pour afficher les remises.
`sale_price_effective_date`	Chaîne	Facultatif	Jour et heure de début et de fin de la réduction, séparés par une barre oblique. Respectez le format suivant pour les dates de début et de fin : AAAA-MM-JJ. Ajoutez un « T » après chaque date, puis ajoutez l’heure. Respectez le format 24 heures pour les heures (de 00:00 à 23:59). Exemple : 2014-11-01T12:00-0300/2014-12-01T00:00-0300.
`additional_image_link`	Chaîne (nombre maximal de caractères : 2 000)	Facultatif	URL d’images supplémentaires de votre article (20 max.), séparées par une virgule (,), un point virgule (;), une espace ( ) ou une barre verticale (\|). Suivez les mêmes spécifications d’image que pour image_link.
`return_details`	Objet JSON nullable (map) { “return_days”: 30, “return_type”: enum } Enum : FINAL_SALE NO_RETURNS_WITH_EXCEPTION NO_RETURNS SELLER_PAID_RETURN BUYER_PAID_RETURN Si les retours sont indisponibles “return_details”: null	Facultatif	return_days indique le nombre de jours dont dispose l’acheteur·se pour retourner le produit. return_days doit être -1 pour les options NO_RETURNS et FINAL_SALE return_type indique le type de retour pris en charge pour le produit. Les options disponibles sont : FINAL_SALE, NO_RETURNS_WITH_EXCEPTION, NO_RETURNS, SELLER_PAID_RETURN, BUYER_PAID_RETURN Si ce champ est vide, aucune information relative aux retours ne sera visible.
`partner_attribute_data`	Objet JSON nullable { “color”: “blue” } Clés disponibles : aspect_ratio, band_material, bike_type, brand, break_type, cable_length, capacity, case_size, certification, character, circulated_uncirculated, closure, color, compatible_bike_type, compatible_brand, compatible_model, compatible_operating_system, compatible_product, connectivity, credit_included, denomination, department, display_technology, dress_length, exterior_color, exterior_material, fabric_type, features, film_format, fit, focal_length, focus_type, form_factor, format, frame_color, game_name, game, gauge, golf_club_type, handedness, inseam, internet_connectivity, item_height, item_length, item_weight, item_width, items_included, main_stone, manufacturer_part_number, manufacturer, material, maximum_aperture, maximum_magnification, maximum_resolution, memory_cards_supported, metal_purity, metal, model, mount, mpn, network, number_of_items, occasion, outer_shell_material, package_quantity, part_type, pattern, performance_activity, platform, processor, publication_name, quantity, rack_type, rim_diameter, rim_width, ring_size, screen_size, section_width, series, set_includes, set, size_type, size, skirt_length, sleeve_length, sport_activity, sport, storage_capacity, style, type, unit_quantity, unit_type, upper_material, us_shoe_size, vintage, voltage, volume, waist_size, wheel_diameter, year	Facultatif	Liste d’attributs clés visible dans la section des informations du produit. Les valeurs sont sous forme de chaîne. Clés applicables aux locations / à l’immobilier : property_type (required), sale_type, bed_bath, area_size, pet_friendly, ac_type, heating_type, laundry_type, parking_type, parkingSpace, furnishing_type, garden_type, tenure_type, listed_by, property_tax_and_condo_fee, construction_status, lease_duration, energy_rating_eu, co2_emission_rating Clés applicables aux véhicules : vehicle_type, year, make, model, number_of_owners, trim, body_style, exterior_color, interior_color, transmission, fuel_type, mileage, money_still_owed, motorcycle_type, engine_size
`partner_product_creation_time`	Timestamp UNIX en secondes UTC (nombre)	Facultatif	Timestamp UNIX indiquant la date de création ou de mise à jour du produit. Exemple : “partner_product_creation_time” : 1713917255
`partner_product_location`	Chaîne	Facultatif	Localisation de l’article sous forme de chaîne à afficher. Exemple : « Paris, France ». Aucune restriction concernant le niveau de précision.
`partner_product_expiration_time`	Timestamp UNIX en secondes UTC (nombre)	Facultatif	Date à laquelle l’annonce sera retirée de Marketplace. La date doit être future.
`partner_delivery_method`	Série de chaînes Enum {shipping, in_person}	Facultatif	Manière dont le produit peut être remis à un·e acheteur·se. Si le produit peut être expédié et remis en main propre, incluez les deux méthodes. Exemple : [“shipping”,”in_person”] Par défaut : [“shipping”]
`partner_item_latitude`	Flottement	Facultatif	Latitude de l’article. Obligatoire si la méthode de livraison inclut « in_person ».
`partner_item_longitude`	Flottement	Facultatif	Longitude de l’article. Obligatoire si la méthode de livraison inclut « in_person ».
`partner_shipping_type`	Enum {free, fixed, dynamic}	Facultatif	Stratégie appliquée aux frais d’expédition de l’article. Si l’expédition est gratuire, utilisez « free ». Si les frais d’expédition sont fixes peu importe la localisation, utilisez « fixed » et saisissez le coût dans partner_shipping_cost. Si les frais d’expédition varient en fonction de la localisation de l’acheteur·se, de choix de variante, etc. utilisez « dynamic ». Si vous choisissez cette option, les frais d’expédition ne seront pas visibles, mais nous indiquerons qu’ils le seront au moment du paiement. Par défaut : « dynamique »
`partner_shipping_cost`	Flottement	Facultatif	Obligatoire si partner_shipping_type est « fixed ». Exemple : “14.95”
`partner_shipping_speed`	Chaîne ‘MIN_DELIVERY_SPEED_IN_DAYS:MAX_DELIVERY_SPEED_IN_DAYS’	Facultatif	Nombre de jours ouvrés maximal et minimal prévu pour expédier l’article. Exemple : “3:5”
`partner_auction_bid_close_time`	Timestamp UNIX en secondes UTC (nombre)	Facultatif	Champ obligatoire si le paramètre partner_listing_type est « enchère ». Il s’agit du moment où l’enchère se termine pour le produit. Exemple : “partner_auction_bid_close_time”: 1713917255
`partner_auction_bid_count`	Numéro	Facultatif	Applicable uniquement si le paramètre partner_listing_type est « enchère ». Il s’agit du nombre actuel d’enchères placées sur le produit.
`additional_fields`	Objet JSON nullable Format libre (pas d’énumération / de clés définies) { “revised_title”: “Premium Blue T-Shirt” }	Facultatif	Champ JSON libre permettant aux partenaires d’envoyer des champs supplémentaires.

Vérifier l’état de l’importation

Après avoir envoyé une requête de création, de mise à jour ou de suppression, vous recevez une notification. Vous pouvez ensuite vérifier les résultats avec une autre requête.

Une fois le traitement terminé, le statut des données sera défini sur « finished », et les erreurs et avertissements seront visibles.

HTTP
GET /v20.0/{product-catalog-id}/check_batch_request_status?handle={your handle}

Exemple de valeur renvoyée :

{
  "data": [
    {
      "handle": "Acy3FUJwzE10XnWrYr4ttrjOAfs-h6BUg-Wtg6sWGeV7qZZaErX15XPfqT_KWeyC6T4-nTbng9r1BJuScb6hgO1B",
      "status": "finished",
      "errors_total_count": 0,
      "errors": [
      ],
      "warnings": [
        {
          "line": 1,
          "id": "YourItemID",
          "message": "These attributes are invalid and need to be updated in the feed file: The product_tags information under  is invalid. Review for more details"
        }
      ],
      "ids_of_invalid_requests": [
      ]
    }
  ],
  "__www_request_id__": "Az3ghYsDh-101IH2t6DXKuP"
}

Voir et gérer les produits

Vous pouvez voir et gérer les produits importés dans le Gestionnaire des ventes. Les problèmes liés à vos produits sont visibles sur le Gestionnaire des ventes et peuvent être résolus dans cet outil.