Partnership di Marketplace

API Item del partner di Marketplace

Essere un partner di Marketplace rende i tuoi annunci disponibili su Facebook Marketplace in alcuni Paesi.

Per caricare, aggiornare o eliminare i tuoi prodotti su Facebook Marketplace, usa l'interfaccia GraphAPI.

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

Se vuoi scoprire come usare l'API Graph, leggi la nostra guida all'uso dell'API Graph.

Quando pubblichi su questo segmento, verrà creato un Articolo.

Parametri

Parametro	Descrizione
item_type	Imposta come PRODUCT_ITEM
requests	Il metodo e i campi per ogni prodotto in una serie di prodotti.

Il parametro request consente di definire il metodo e i dati della tua richiesta.

Campo	Descrizione
method	L'azione che desideri eseguire per un determinato prodotto. Le opzioni sono: CREATE UPDATE DELETE
data	Le informazioni sul prodotto da creare, aggiornare o eliminare.

Esempio di parametro requests

[
    {
        "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}
]

Rate limiting dell'API

Per evitare il throttling, segui questi consigli:

Non superare le 30 chiamate al minuto. In caso contrario, si verificherà il throttling.
Raggruppa gli articoli (fino a 300) in un'unica chiamata API.

Campi dell'articolo

Parametro	Tipo	Obbligatorio/facoltativo	Descrizione
`id`	Stringa (limite massimo di caratteri: 100)	Obbligatorio	Un ID contenuto univoco per l'articolo. Se possibile, utilizza il codice SKU dell'articolo. Ogni ID contenuto deve essere visibile una sola volta nel catalogo. In caso di più istanze dello stesso ID, ignoreremo tutte le istanze. Se gli articoli sono disponibili in più Paesi, devi riutilizzare lo stesso ID in tutti i cataloghi. Assicurati di aggiornare il prezzo in base alla valuta del Paese (vedi il campo prezzi).
`title`	Stringa (limite caratteri: 200)	Obbligatorio	Il titolo dell'articolo che viene visualizzato nell'annuncio di Marketplace. Questo testo sarà visualizzato su Marketplace. Non includere tag HTML.
`description`	Stringa (limite caratteri: 9 999)	Obbligatorio	Descrizione del prodotto. Anche se il limite di caratteri di questo campo è 9999, solo i primi 256 caratteri saranno mostrati nell'annuncio su Facebook Marketplace. Questo testo sarà visualizzato su Marketplace. Non includere tag HTML. Esempio: T-shirt da donna confortevole di colore blu reale in cotone biologico, con maniche ad aletta e taglio morbido. Ideale nelle calde giornate estive.
`condition`	Enum {new, refurbished, used, used_like_new, used_good, used_fair, cpo, open_box_new}	Obbligatorio	Le condizioni dell'articolo.
`partner_listing_type`	Enum {fixed_price, auction, vehicle, rental, real_estate}	Facoltativo	Ciò determina il tipo di annuncio. Se non viene effettuata nessuna selezione, l'impostazione predefinita sarà "fixed_price". Se viene impostato su "auction", "vehicle", "rental" o "real_estate", verrà offerta un'esperienza di tipo di annuncio del partner specifica per gli acquirenti su 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}	Facoltativo	Condizioni del prodotto. Campo facoltativo che sovrascriverà il campo di condizione. Da usare per fornire informazioni più specifiche sulle condizioni del prodotto.
`brand`	Stringa	Obbligatorio	Il brand del prodotto. Da impostare su "N/D" se non esiste un brand.
`price`	Stringa (limite caratteri: 9 999)	Obbligatorio	Formatta il prezzo come numero, seguito da uno spazio e dalle 3 lettere del codice ISO 4217 per la valuta. Esempio: 10,99 EUR Se il tipo di annuncio è "asta", questo è il prezzo di offerta del prodotto. Formatta il prezzo come numero, seguito da uno spazio e dalle 3 lettere del codice ISO 4217 per la valuta.
`availability`	Enum {in stock, out of stock}	Obbligatorio	La disponibilità del prodotto
`link`	Stringa	Obbligatorio	Il link web dell'URL mobile alla pagina dei dettagli del prodotto.
`partner_product_checkout_uri`	Stringa	Facoltativo	Il link URL a cui indirizzeremo l'utente quando tocca Acquista sull'annuncio. Aggiungeremo click_id al parametro. Se mancante, utilizzeremo come predefinito l'URL presente nel campo "link".
`partner_product_html_desc_uri`	Stringa	Facoltativo	L'URL del link al sito con descrizione completa del prodotto. Utilizzato se la descrizione del prodotto contiene più di quanto possa rientrare nel campo di testo "descrizione". Marketplace fornirà opzionalmente un link alla descrizione completa.
`image_link`	Stringa	Obbligatorio	L'URL dell'immagine principale dell'articolo. Le immagini devono avere formati JPEG o PNG ed essere di almeno 500 x 500 pixel per un massimo di 8 MB. Consulta le specifiche dell'immagine del prodotto.
`partner_seller_id`	Stringa (limite massimo di caratteri: 100)	Obbligatorio	L'identificatore univoco del venditore. Deve corrispondere a partner_seller_id nelle informazioni del venditore. Esempio: "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}	Obbligatorio	Questo è il Paese in cui il prodotto è disponibile e, se applicabile, può essere spedito. Il Paese del catalogo e partner_item_country dovranno corrispondere. Per gli articoli che supportano la spedizione transfrontaliera, è necessario creare un articolo in ogni catalogo del Paese in cui la spedizione è supportata e in cui il partner intende distribuire gli articoli.
`fb_product_category`	Stringa	Facoltativo	La categoria prodotto di Facebook per l'articolo. Scegli la categoria di prodotto Facebook più specifica possibile dalla lista seguente: Foglio di calcolo (.csv) o Testo semplice (.txt).
`status`	Enum {active, archived}	Facoltativo	Lo stato attuale del prodotto.
`sale_price`	Stringa	Facoltativo	Formatta il prezzo come numero, seguito da uno spazio e dalle 3 lettere del codice ISO 4217 per la valuta. Esempio: 10,99 EUR. Questo è lo stesso formato del campo prezzi. Da usare in combinazione con il campo Prezzo per mostrare gli sconti.
`sale_price_effective_date`	Stringa	Facoltativo	Data e ora di inizio e fine della promozione, separati da uno slash. Scrivi le date di inizio e fine nel formato AAAA-MM-GG. Aggiungi una "T" dopo ogni data e quindi includi l'ora. Scrivi l'orario nel formato 24 ore (0:00-23:59). Esempio: 2014-11-01T12:00-0300/2014-12-01T00:00-0300.
`additional_image_link`	Stringa (limite caratteri: 2 000)	Facoltativo	URL per un massimo di 20 immagini aggiuntive del tuo articolo, separati da una virgola (,), un punto e virgola (;), uno spazio ( ) o una barra verticale (\|). Segui le stesse specifiche dell'immagine di image_link.
`return_details`	Oggetto json nullable (ad esempio, mappa) { "return_days": 30, "return_type": enum } enum: FINAL_SALE NO_RETURNS_WITH_EXCEPTION NO_RETURNS SELLER_PAID_RETURN BUYER_PAID_RETURN Oppure, se i resi non sono disponibili "return_details": null	Facoltativo	return_days indica il numero di giorni entro i quali l'acquirente deve iniziare il reso del prodotto. return_days dovrebbe essere -1 per NO_RETURNS e FINAL_SALE return_type indica il tipo di reso supportato del prodotto. Le opzioni disponibili includono: FINAL_SALE, NO_RETURNS_WITH_EXCEPTION, NO_RETURNS, SELLER_PAID_RETURN, BUYER_PAID_RETURN Se lasciato vuoto, i dettagli del reso non verranno mostrati.
`partner_attribute_data`	Oggetto json nullable { "color": "blue" } Chiavi disponibili: 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	Facoltativo	Un elenco di attributi chiave che saranno visualizzati nella sezione dettagli del prodotto. I valori sono in formato stringa. Chiavi applicabili ad affitti/immobiliare: property_type (obbligatorio), 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 Chiavi applicabili ai veicoli: 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`	Marca temporale UNIX in secondi UTC (numero)	Facoltativo	Marca temporale UNIX del momento in cui il prodotto è stato creato o aggiornato. Esempio: "partner_product_creation_time": 1713917255
`partner_product_location`	Stringa	Facoltativo	La posizione dell'articolo come stringa da mostrare. Esempio: "Parigi, Francia". Nessuna restrizione su quanto questa possa essere specifica o ampia.
`partner_product_expiration_time`	Marca temporale UNIX in secondi UTC (numero)	Facoltativo	Orario in cui l'annuncio sarà rimosso da Marketplace. Dev'essere un orario nel futuro.
`partner_delivery_method`	Array di enum di stringhe {shipping, in_person}	Facoltativo	Questo indica come il prodotto può essere consegnato a un acquirente. Se un prodotto può essere spedito e ritirato di persona, includi entrambi. Esempio: ["shipping","in_person"] Impostazione predefinita: ["shipping"]
`partner_item_latitude`	Float	Facoltativo	Latitudine dell'articolo Obbligatorio se il metodo di spedizione include "in_person".
`partner_item_longitude`	Float	Facoltativo	Longitudine dell'articolo Obbligatorio se il metodo di spedizione include "in_person".
`partner_shipping_type`	Enum {free, fixed, dynamic}	Facoltativo	La strategia relativa al prezzo di spedizione dell'articolo. Se la spedizione è gratuita, usa "free". Se la spedizione è un prezzo fisso indipendentemente dal luogo, usa "fisso" e imposta il costo in partner_shipping_cost. Se il prezzo di spedizione varia in base al luogo dell'acquirente, alla scelta delle varianti e così via, scegli "dynamic". In questo caso, non mostreremo i costi di spedizione, ma indicheremo che i costi di spedizione saranno specificati al momento dell'acquisto. Impostazione predefinita: "dynamic"
`partner_shipping_cost`	Float	Facoltativo	Obbligatorio se partner_shipping_type è "fixed". Esempio: "14,95"
`partner_shipping_speed`	Stringa ‘MIN_DELIVERY_SPEED_IN_DAYS:MAX_DELIVERY_SPEED_IN_DAYS’	Facoltativo	Giorni lavorativi minimi e massimi previsti per spedire l'articolo. Esempio: "3:5"
`partner_auction_bid_close_time`	Marca temporale UNIX in secondi UTC (numero)	Facoltativo	Campo obbligatorio se partner_listing_type è "asta". Indica quando termina l'offerta per il prodotto. Esempio: "partner_auction_bid_close_time": 1713917255
`partner_auction_bid_count`	Numero	Facoltativo	Applicabile solo se partner_listing_type è "asta". Questo è il numero attuale di offerte sul prodotto.
`additional_fields`	Oggetto json nullable Formato libero (nessuna enumerazione/chiave fissa) { "revised_title": "Premium Blue T-Shirt" }	Facoltativo	Un campo JSON libero che i partner possono usare per inviare eventuali campi aggiuntivi.

Controllo dello stato di caricamento

Dopo aver inviato una richiesta di creazione, aggiornamento o eliminazione, ti verrà restituito un handle. Puoi quindi controllare il risultato dell'invio con un'altra richiesta.

I dati -> lo stato sarà impostato su "finished" al completamento e saranno visualizzati errori ed avvisi.

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

Esempio di reso

{
  "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"
}

Visualizzazione e gestione dei prodotti

Per visualizzare o gestire i prodotti caricati su Gestore delle vendite. Eventuali problemi con i tuoi prodotti saranno visualizzati in Gestore delle vendite e potrebbero essere risolti nello strumento.