Risorsa Prodotti

Articolo
12/21/2023

La risorsa Prodotti consente di gestire le offerte di prodotti nel Microsoft Merchant Center Store (MMC). Per informazioni sull'uso delle risorse Products, vedere Gestione dei prodotti. Per esempi che illustrano come aggiungere, eliminare e ottenere prodotti, vedere Esempi di codice.

Base URI

Di seguito è riportato l'URI di base a cui si aggiungono i modelli.

https://content.api.bingads.microsoft.com/shopping/v9.1/bmc/

Modelli

Per creare gli endpoint usati per gestire le offerte di prodotto, aggiungere il modello appropriato all'URI di base.

Modello	Verbo HTTP	Descrizione	Risorsa
`{mmcMerchantId}/products/batch`	POST	Consente di eseguire più inserimenti (aggiornamenti), ottiene ed elimina in una singola richiesta. Il batch non deve includere più azioni per lo stesso prodotto. Ad esempio, la richiesta non deve tentare di inserire ed eliminare lo stesso prodotto. Impostare sull'ID `{mmcMerchantId}` archivio MMC.	Richiesta: Batch Risposta: Batch
`{mmcMerchantId}/products/{productUniqueId}`	ELIMINA	Usare per eliminare una singola offerta di prodotti dal negozio. Impostare sull'ID `{mmcMerchantId}` archivio MMC. Impostare `{productUniqueId}`sull'ID prodotto completo, ad esempio Online:en:US:Sku123. Se è stato inserito un prodotto con lo stesso ID in più cataloghi, viene eliminato da tutti. I prodotti eliminati possono richiedere fino a 12 ore per interrompere la consegna. È consigliabile aggiornare la disponibilità del prodotto a "esaurito" prima dell'eliminazione.	Richiesta: N/D Risposta: N/D
`{mmcMerchantId}/products/{productUniqueId}`	GET	Usare per ottenere un'offerta di prodotto singola dal negozio. Impostare sull'ID `{mmcMerchantId}` archivio MMC. Impostare `{productUniqueId}`sull'ID prodotto completo, ad esempio Online:en:US:Sku123. Se è stato inserito un prodotto con lo stesso ID in più cataloghi, il servizio ne restituisce solo uno e quello non determinato.	Richiesta: N/D Risposta: Prodotto
`{mmcMerchantId}/products`	GET	Usare per ottenere un elenco di prodotti nel negozio. Impostare sull'ID `{mmcMerchantId}` archivio MMC.	Richiesta: N/D Risposta: Prodotti
`{mmcMerchantId}/products`	POST	Usare per inserire (aggiornare) una singola offerta di prodotto nel negozio. Se il prodotto non esiste, viene aggiunto; in caso contrario, il prodotto viene aggiornato. Poiché gli aggiornamenti sovrascrivono l'offerta corrente, è necessario includere tutti i campi che costituiscono l'offerta. Per inserire l'offerta in un catalogo specifico, specificare il parametro di query bmc-catalog-id ; in caso contrario, il prodotto viene inserito nel catalogo predefinito dello store. Impostare sull'ID `{mmcMerchantId}` archivio MMC. Si noti che poiché le richieste Get/List ed Delete agiscono sullo store e non su un catalogo specifico, non è consigliabile inserire un prodotto con lo stesso canale, contentLanguage, targetCountry e offerId in più cataloghi.	Richiesta: Prodotto Risposta: Prodotto

Parametri di query

Gli endpoint possono includere i parametri di query seguenti.

Parametro	Descrizione
Alt	Facoltativo. Usare per specificare il tipo di contenuto usato nella richiesta e nella risposta. I valori possibili sono `json` e `xml`. Il valore predefinito è `json`.
bmc-catalog-id	Facoltativo. Usare per specificare il catalogo in cui inserire le offerte di prodotti (aggiornamento). Usare questo parametro se l'archivio contiene più cataloghi. Se non si specifica questo parametro, il prodotto viene inserito nel catalogo predefinito dello store. Questo parametro viene usato solo per inserire offerte di prodotti. Questo parametro viene ignorato per le richieste Get, List ed Delete perché funzionano tra cataloghi.
dry-run	Facoltativo. Usare quando si esegue il debug dell'applicazione per testare le chiamate. Le chiamate che includono questo parametro non influiscono sui dati di produzione (i prodotti non vengono inseriti o eliminati); tuttavia, la risposta conterrà eventuali errori generati dalla chiamata. Quando si usa questo parametro, considerare le limitazioni seguenti. Le operazioni di inserimento non restituiscono ID. Il servizio non genera o restituisce messaggi di errore secondari, ad esempio qualità dei dati, problemi editoriali e convalide correlate al database. Per altre informazioni sul test dell'applicazione, vedere Sandbox.
max-results	Facoltativo. Utilizzare per specificare il numero massimo di elementi da restituire in una richiesta Elenco. Il valore massimo che è possibile specificare è 250. Il valore predefinito è 25.
start-token	Facoltativo. Usare per sfogliare l'elenco di prodotti di un negozio. Il token identifica la pagina successiva dei prodotti da restituire in una richiesta List. Non specificare questo parametro nella prima richiesta List. Se il catalogo contiene più del numero di prodotti richiesto (vedere il parametro di query max-results ), la risposta include il `nextPageToken` campo (vedere Products), che contiene il valore del token usato nella richiesta elenco successiva.

Intestazioni

Di seguito sono riportate le intestazioni di richiesta e risposta.

Intestazione	Descrizione
AuthenticationToken	Intestazione della richiesta. Impostare questa intestazione su un token di accesso OAuth. Per informazioni su come ottenere un token di accesso, vedere Autenticazione delle credenziali.
Content-Location	Intestazione della risposta. URL che identifica lo store in cui è stato inserito il prodotto. Questa intestazione è inclusa nella risposta di una richiesta Insert.
Content-Type	Intestazione della richiesta e della risposta. Tipo di contenuto nel corpo della richiesta o della risposta. Per I POST, se si usa JSON, impostare questa intestazione su `application/json`. In caso contrario, se si usa XML, impostare questa intestazione su `application/xml`.
CustomerAccountId	Intestazione della richiesta. ID account di qualsiasi account gestito per conto del cliente specificato nell'intestazione `CustomerId` . Non importa quale account specificare. Specificare questa intestazione solo se si gestisce un account per conto del cliente.
Customerid	Intestazione della richiesta. ID cliente del cliente di cui si gestisce il negozio. Specificare questa intestazione solo se si gestisce lo store per conto del cliente. Se si imposta questa intestazione, è necessario impostare anche l'intestazione `CustomerAccountId` .
DeveloperToken	Intestazione della richiesta. Token di sviluppo dell'applicazione client. Ogni richiesta deve includere questa intestazione. Per informazioni su come ottenere un token, vedere Le credenziali di Microsoft Advertising e il token per sviluppatori sono disponibili?
Posizione	Intestazione della risposta. URL che identifica lo store in cui è stato inserito il prodotto. Questa intestazione è inclusa nella risposta di una richiesta Insert.
WebRequestActivityId	Intestazione della risposta. ID della voce di log che contiene i dettagli della richiesta. È consigliabile acquisire sempre questo ID se si verifica un errore. Se non si è in grado di determinare e risolvere il problema, includere questo ID insieme alle altre informazioni fornite al team di supporto.

Oggetti richiesta e risposta

Di seguito sono riportati gli oggetti richiesta e risposta usati dall'API.

Ogni oggetto definisce il nome della chiave JSON e il nome dell'elemento XML usati a seconda del tipo di contenuto specificato per la richiesta.

Oggetto	Descrizione
Lotto	Definisce l'elenco di elementi da elaborare in una richiesta batch.
Errore	Definisce un errore.
ErrorResponse	Definisce l'oggetto errore di primo livello per un singolo inserimento di prodotti.
BatchItemError	Definisce gli errori che si sono verificati per un elemento durante l'elaborazione batch.
Elemento	Definisce un elemento in una richiesta o una risposta batch.
Prodotto	Definisce un prodotto.
ProductCustomAttribute	Definisce un attributo personalizzato.
ProductCustomGroup	Definisce un gruppo di attributi personalizzati.
ProductDestination	Definisce una destinazione.
ProductPrice	Definisce il prezzo di un prodotto.
ProductTax	Definisce la posizione geografica che determina le imposte applicabili.
Prodotti	Definisce un elenco di prodotti.
ProductShipping	Definisce il costo di spedizione.
ProductShippingWeight	Definisce il peso di spedizione dell'elemento.
UnitPricing	Definisce il prezzo unitario dell'articolo.
Avviso	Definisce un messaggio di avviso.

Lotto

Definisce l'elenco di elementi da elaborare in una richiesta batch. Si noti che questo oggetto viene utilizzato in una richiesta e una risposta batch.

Name	Valore	Tipo	Nome elemento XML
Voci	Matrice di elementi da elaborare in una richiesta batch. Il numero massimo di elementi che è possibile specificare è 12.000. Tuttavia, la dimensione massima della richiesta è di 4 MB, quindi il numero effettivo di elementi dipende dal numero di attributi del prodotto (ad esempio dimensioni, colore, modello) inclusi e dalla compressione dei dati. Ad esempio, se si comprimeno i dati, è possibile specificare 12.000 elementi, ma in caso contrario, è possibile specificare solo 2.000 elementi.	Elemento[]	<lotto>

BatchItemError

Definisce gli errori che si sono verificati per un elemento durante l'elaborazione batch.

Name	Valore	Tipo	Nome elemento XML
Errori	Elenco di errori che si sono verificati durante l'elaborazione dell'elemento.	Errore[]	<Errori>
code	Codice di stato HTTP dell'errore.	Stringa
messaggio	Messaggio associato all'errore.	Stringa

Error

Definisce un errore.

Name	Valore	Tipo	Nome elemento XML
dominio	Solo per uso interno.	Stringa	<Dominio>
posizione	Non utilizzata.	Stringa	<location type="string">
locationType	Non utilizzata.	Stringa	Vedere l'attributo type dell'elemento <location>
messaggio	Descrizione dell'errore.	Stringa	<internalReason>
motivo	Motivo per cui la richiesta non è riuscita. Ad esempio, la convalida del prodotto non è riuscita.	Stringa	<Motivo>

ErrorResponse

Definisce l'oggetto errore di primo livello per un singolo inserimento di prodotti.

Name	Valore	Tipo	Nome elemento XML
Errore	Elenco di errori che si sono verificati durante l'elaborazione dell'elemento.	Errori[]	<Errore>

Errori

Definisce l'elenco di errori e avvisi per un'offerta.

Name	Valore	Tipo	Nome elemento XML
Errori	Elenco di errori che si sono verificati durante l'elaborazione dell'elemento.	Errore[]	<Errori>
Avvertenze	Elenco di avvisi che si sono verificati durante l'elaborazione dell'elemento. L'offerta è stata accettata, ma è consigliabile risolvere i problemi al più presto. Ad esempio, MMC restituisce avvisi se non si specificano gli identificatori gtin, mpn e del marchio , se devono essere noti.	Avviso[]	<Avvertenze>
code	Codice di stato HTTP o errore.	Stringa
messaggio	Messaggio associato all'errore.	Stringa

Elemento

Definisce un elemento in una richiesta batch.

Name	Valore	Tipo	Nome elemento XML
Batchid	ID definito dall'utente che identifica questo elemento nella richiesta batch. Ad esempio, se il batch contiene 10 elementi, è possibile assegnargli gli ID da 1 a 10.	Unsigned Integer	<entry batch_id="unsigned integer" method="string">
Errori	Oggetto errore che contiene un elenco di errori di convalida che si sono verificati. La risposta include questo campo solo quando si verifica un errore.	BatchItemError	<Errori>
merchantId	ID archivio Merchant Center.	Long senza segno	<merchant_id>
Metodo	Azione da applicare all'elemento. I valori possibili sono `insert`, `get`e `delete`. Se l'elemento sta aggiungendo o aggiornando un'offerta di prodotto, impostare il metodo`insert`su ; se l'elemento sta eliminando un prodotto, impostare il metodo`delete`su e se l'elemento ottiene un prodotto, impostare il metodo`get`su . Le stringhe non fanno distinzione tra maiuscole e minuscole.	Stringa	Vedere l'attributo `method` dell'elemento <entry>
Prodotto	L'offerta del prodotto. Specificare questo campo in una richiesta solo se si inserisce (aggiorna) un prodotto. La risposta includerà questo campo solo per ottiene e inserisce (aggiornamenti).	Prodotto	<Prodotto>
Productid	ID prodotto completo, ad esempio Online:en:US:Sku123. Includere questo campo solo quando si ottiene o si elimina un'offerta di prodotto. Non includere più elementi con lo stesso ID prodotto in una richiesta batch.	Stringa	<product_id>

Prodotto

Definisce un prodotto. Per altre informazioni sui campi in questo oggetto, vedere Come è organizzato il file di feed?

JSON e nome XML	Valore	Tipo	Obbligatorio per l'inserimento
additionalImageLinks <additional_image_link>	URL di immagini aggiuntive del prodotto che possono essere usate nell'annuncio del prodotto. Per specificare più immagini, MMC non usa le immagini aggiuntive; questo campo è incluso per la compatibilità con Google.	String[]	No
Adulto <Adulto>	Valore booleano che determina se l'elemento è un prodotto per adulti. Impostare su true se il mercato di destinazione dell'elemento è adulti. Il valore predefinito è false. Si noti che i prodotti per adulti non sono supportati e verranno rifiutati.	Booleano	No
adwordsGrouping <adwords_grouping>	Un gruppo di elementi per l'offerta Costo per acquisizione (CPA). MMC non usa questo campo; è incluso per la compatibilità con Google.	Stringa	No
adwordsLabels <adwords_label>	Etichette per gli elementi raggruppati (vedere adwordsGrouping). Si applica solo al costo per clic (CPC). MMC non usa questo campo; è incluso per la compatibilità con Google.	String[]	No
adwordsRedirect <adwords_redirect>	URL da usare nell'annuncio del prodotto. Se specificato, questo URL deve essere reindirizzato all'URL specificato nel collegamento.	Stringa	No
ageGroup <age_group>	Gruppo di età di destinazione dell'elemento. Di seguito sono riportati i valori possibili. Adulto Bambini Bambino Neonato Neonato	Stringa	No
Disponibilità <Disponibilità>	Stato di disponibilità del prodotto. Di seguito sono riportati i valori possibili. in magazzino esaurito Preorder Il valore predefinito è disponibile in magazzino.	Stringa	Sì
availabilityDate <availability_date>	Data UTC in cui un prodotto di pre-ordine sarà disponibile per la spedizione (vedere il `availability` campo ). Questo campo è facoltativo, ma se si conosce la data in cui il prodotto preordinato sarà disponibile per la spedizione, è necessario impostare questo campo. Specificare la data nel formato ISO 8601. NOTA: MMC attualmente ignora il contenuto di questo campo.	Stringa	No
Marchio <Marchio>	Marchio, produttore o editore dell'elemento. La stringa può contenere un massimo di 10 parole e 1.000 caratteri. Per garantire che la stringa venga visualizzata correttamente nell'esperienza utente, è necessario limitare il nome del marchio a non più di 70 caratteri.	Stringa	Sì
Canale <Canale>	Canale di vendita per il prodotto. Di seguito sono riportati i possibili valori senza distinzione tra maiuscole e minuscole. Locale Online Poiché il canale viene usato per creare l'ID prodotto, non è possibile modificare questo campo dopo aver aggiunto il prodotto allo store.	Stringa	Sì
Colore <Colore>	Colore dominante del prodotto. Se il colore è una miscela di colori, è possibile specificare un elenco delimitato da barre di un massimo di 3 colori ,ad esempio rosso/verde/blu. Se un vestito è disponibile in più colori, si creerà un prodotto per ogni colore e si userà itemGroupId per raggruppare le varianti del prodotto. Il campo è limitato a 100 caratteri. Consigliato per gli articoli di abbigliamento.	Stringa	No
Condizione <Condizione>	Condizione del prodotto. Di seguito sono riportati i valori possibili. Nuovo Ristrutturato Utilizzato Il valore predefinito è nuovo.	Stringa	Sì
contentLanguage <content_language>	Codice di lingua ISO 639-1 di due lettere per il prodotto. Di seguito sono riportati i possibili valori senza distinzione tra maiuscole e minuscole: Albanese (sq) Bosniaco (bs) Bulgaro (bg) Croato (hr) Ceco (cs) Olandese (nl) Inglese (en) Estone (et) Francese (fr) Tedesco (de) Greco (el) Ungherese (hu) Islandese (is) Italiano (it) Lettone (lv) Lituano (lt) Macedone (mk) Maltesi (mt) Polacco (pl) Portoghese (pt) Romeno (ro) Serbo (sr) Slovacco (sk) Sloveno (sl) Spagnolo (es) Svedese (sv) Turco (tr) Poiché la lingua viene usata per creare l'ID prodotto, non è possibile modificare questo campo dopo aver aggiunto il prodotto allo store.	Stringa	Sì
Customattributes <custom_attribute>	Elenco di attributi personalizzati usati dal commerciante.	ProductCustomAttribute[]	No
customGroups<custom_group>	Elenco di gruppi personalizzati usati dal commerciante.	ProductCustomGroup[]	No
customLabel0 <custom_label_0>	Etichetta personalizzata 0, usata per filtrare i prodotti per le campagne di Microsoft Shopping. L'etichetta è limitata a 100 caratteri.	Stringa	No
customLabel1 <custom_label_1>	Etichetta personalizzata 1, usata per filtrare i prodotti per le campagne di Microsoft Shopping. L'etichetta è limitata a 100 caratteri.	Stringa	No
customLabel2 <custom_label_2>	Etichetta personalizzata 2, usata per filtrare i prodotti per le campagne di Microsoft Shopping. L'etichetta è limitata a 100 caratteri.	Stringa	No
customLabel3 <custom_label_3>	Etichetta personalizzata 3, usata per filtrare i prodotti per le campagne di Microsoft Shopping. L'etichetta è limitata a 100 caratteri.	Stringa	No
customLabel4 <custom_label_4>	Etichetta personalizzata 4, usata per filtrare i prodotti per le campagne di Microsoft Shopping. L'etichetta è limitata a 100 caratteri.	Stringa	No
descrizione <Descrizione>	Descrizione del prodotto. La descrizione potrebbe non includere testo promozionale. La descrizione è limitata a un massimo di 10.000 caratteri e può includere qualsiasi carattere Unicode. La descrizione sarà sottoposta a revisione editoriale.	Stringa	No
Destinazioni <Destinazione>	Destinazioni previste del prodotto. MMC non usa questo campo; è incluso per la compatibilità con Google.	ProductDestination[]	No
energyEfficiencyClass <energy_efficiency_class>	La classe di efficienza energetica definita nella direttiva UE 2010/30/UE. Di seguito sono riportati i valori possibili. A A+ A++ A+++ B C D E F G	Stringa	No
expirationDate <expiration_date>	Data e ora UTC che specificano quando scadrà il prodotto. Se non si specifica una data di scadenza, il prodotto scade 30 giorni dalla data e dall'ora in cui si aggiunge o si aggiorna il prodotto (la data e l'ora si basano sul fuso orario del server Microsoft). Usare questo campo per specificare una data di scadenza inferiore a 30 giorni da oggi. La data di scadenza deve includere sempre il componente ora e specificare le informazioni sul fuso orario o sull'offset. In caso contrario, l'API tenterà di determinare il fuso orario usando targetCountry. Per i paesi o le aree geografiche con più fusi orari, l'API determina il fuso orario da usare. Ad esempio, se il paese è Stati Uniti, l'API userà l'ora solare pacifico (PST). È consigliabile tenere traccia dei prodotti che si avvicinano alla scadenza e prima della scadenza aggiornare la data di scadenza o semplicemente aggiornare il prodotto (non è necessario aggiornare alcun campo del prodotto) che estenderà automaticamente la data di scadenza per altri 30 giorni. Se si imposta in modo esplicito la data di scadenza, è necessario impostare manualmente una nuova data di scadenza. l'aggiornamento del prodotto non estenderà automaticamente la data di scadenza di altri 30 giorni in questo caso.	Stringa	No
Genere <Genere>	Sesso a cui si rivolge il prodotto. Di seguito sono riportati i valori possibili. Donna Uomo Unisex	Stringa	No
googleProductCategory <google_product_category>	Categoria di prodotti in cui si trova il prodotto. È possibile specificare una stringa di categoria (ad esempio, Animals & Pet Supplies > Pet supplies Bird Supplies > ) o un ID categoria (ad esempio, 3). Per una stringa di categoria, l'elenco di sottocategorie è delimitato dal simbolo maggiore di ('').For a category string, the list of subcategories is delimited by the greater than symbol ('>''). Il campo è limitato a 255 caratteri. Per un elenco di stringhe e ID di categoria, vedere Categorie.	Stringa	No
gtin <gtin>	Numero dell'elemento di scambio globale (GTIN) assegnato dal produttore. Se il produttore assegna un GTIN, è necessario specificarlo. Di seguito sono riportati i tipi di GTIN. EAN (Numero articolo europeo) ISBN (International Standard Book Number) JAN (numero articolo giapponese) UPC (Universal Product Code)	Stringa	Sì
Id <Id>	ID prodotto completo. L'ID è un composito di canale, contentLanguage, targetCountry e offerId. L'ID fa distinzione tra maiuscole e minuscole. Usare questo ID per ottenere o eliminare un prodotto.	Stringa	No
identifierExists <identifier_exists>	Valore booleano che determina se l'offerta di prodotto specifica gli identificatori gtin, mpn o del marchio . Il valore predefinito è true. Impostare su false se non si specificano tutti e tre gli identificatori. Gli identificatori univoci del prodotto definiscono un prodotto in un marketplace globale. Contrassegnare i prodotti con identificatori univoci semplifica la ricerca dei prodotti da parte dei clienti. È necessario specificare tutti e tre gli identificatori, se noti.	Booleano	No
imageLink <image_link>	URL di un'immagine del prodotto che può essere usata nell'annuncio del prodotto. L'URL è limitato a 1.000 caratteri e può usare il protocollo HTTP o HTTPS. I tipi di immagine consentiti sono bmp, gif, exif, jpg, png e tiff. Le dimensioni consigliate dell'immagine sono 200x200 pixel. L'immagine non può superare i 3,9 MB. L'immagine sarà sottoposta a revisione editoriale.	Stringa	Sì
isBundle <is_bundle>	Valore booleano che determina se il prodotto è un bundle definito dall'esercente. Il valore è true se il prodotto è un bundle.	Booleano	No
itemGroupId <item_group_id>	ID che può essere usato per raggruppare tutte le varianti dello stesso prodotto. Ad esempio, se il vestito è disponibile in 3 colori, è possibile creare un prodotto per ogni colore e usare questo ID per raggrupparli. In genere, si raggruppano elementi che variano in base a colore, materiale, motivo o dimensione. L'ID deve essere univoco all'interno di un catalogo ed è limitato a 50 caratteri.	Stringa	No
gentile <gentile>	Tipo dell'oggetto. Questo campo è impostato su `content#product`.	Stringa	No
Link <Link>	URL della pagina del prodotto nel sito Web. L'URL è limitato a 2.000 caratteri e può usare il protocollo HTTP o HTTPS. Il dominio deve corrispondere al dominio dell'archivio. Il collegamento viene usato nell'annuncio del prodotto. L'URL potrebbe non essere reindirizzato. Per usare un altro URL nell'annuncio del prodotto che può essere reindirizzato a questo URL, vedere adwordsRedirect. La pagina Web a cui fa riferimento questo collegamento sarà sottoposta a revisione editoriale.	Stringa	Sì
Materiale <Materiale>	Il materiale dominante del prodotto. Se il materiale è una miscela di materiali, è possibile specificare un elenco delimitato da barre di un massimo di 3 materiali (ad esempio pelle/camoscio/seta). Se un vestito è disponibile in più materiali, si creerà un prodotto per ogni materiale e si userà itemGroupId per raggruppare le varianti del prodotto. Il campo è limitato a 200 caratteri. Consigliato per gli articoli di abbigliamento.	Stringa	No
mobileLink <mobile_link>	URL di una versione ottimizzata per dispositivi mobili della pagina Web che contiene informazioni sul prodotto (vedere il collegamento).	Stringa	No
Multipack <Multipack>	Numero di prodotti identici venduti come singola unità (ad esempio, 4 torcie). Quando si imposta il prezzo, deve essere il prezzo totale del multipack.	Numero intero	No
Mpn <Mpn>	Numero di parte del produttore (MPN) del prodotto. Se il produttore assegna un MPN, è necessario specificarlo. L'MPN è limitato a 70 caratteri.	Stringa	Sì
offerId <offer_id>	ID definito dall'utente del prodotto offerto. L'ID offerta non fa distinzione tra maiuscole e minuscole e deve essere univoco all'interno di un catalogo ed è limitato a un massimo di 50 caratteri. Poiché l'ID offerta viene usato per creare l'ID prodotto, non è possibile modificare questo campo dopo aver aggiunto il prodotto al negozio.	Stringa	Sì
onlineOnly <online_only>	Valore booleano che determina se il prodotto è disponibile solo per l'acquisto online. Il valore è true se il prodotto è disponibile solo online. Il valore predefinito è false.	Booleano	No
Modello <Modello>	Motivo o stampa grafica del prodotto (ad esempio, plaid). Il modello è limitato a 100 caratteri. Se un vestito è disponibile in più modelli, è possibile creare un prodotto per ogni modello e usare itemGroupId per raggruppare le varianti del prodotto. Consigliato per gli articoli di abbigliamento.	Stringa	No
Prezzo <Prezzo>	Prezzo del prodotto. Specificare il prezzo nella valuta del paese di destinazione. Per informazioni sull'inclusione delle imposte nel prezzo, vedere Criteri fiscali del catalogo di Microsoft Merchant Center. Il prezzo deve corrispondere al prezzo visualizzato nella pagina Web del prodotto (vedere il collegamento) e deve essere compreso tra 0,01 (1 cent) e 10000000,00 (10 milioni). Tuttavia, se vengono soddisfatte le condizioni seguenti, è possibile impostare il prezzo su 0,0 (zero). 1. Il campo googleProductCategory è impostato su una delle categorie seguenti: - Elettronica > Comunicazioni > Telefonia > Cellulare - Computer > elettronici > Tablet Computer 2. Il campo del titolo contiene una delle parole chiave seguenti: -Contratto -Rata -Locazione -Pagamento Le parole chiave precedenti sono visualizzate in inglese; tuttavia, il titolo e la parola chiave devono essere nella lingua del mercato specificato. In genere, il titolo conterrà formulazioni come "... con piano di rata" o "... solo con contratto". La parola chiave contract può essere usata in tutti i mercati; tuttavia, la rata, il pagamento e il lease possono essere usati solo nel mercato statunitense.	ProductPrice	Sì
productType <product_type>	Categoria di prodotti definita dall'inserzionista, che può essere diversa da `googleProductCategory`. Ad esempio, Animals & Pet Supplies > Pet supplies Bird Supplies >> Veterinary. L'elenco di sottocategorie è delimitato dal simbolo maggiore di ('>'). Il campo è limitato a 750 caratteri. È possibile specificare più stringhe di categoria delimitate da virgole. Ad esempio, Costumi & Accessori > Wig Accessori > Wig Caps, Costumi & Accessori > Accessori Parrucca > Colla.	Stringa	No
promotionId <promotion_id>	Elenco delimitato da virgole di ID che identificano le promozioni nel feed Promozioni. È possibile specificare un massimo di 10 ID promozione. L'ID deve contenere un minimo di 1 carattere e un massimo di 60 caratteri. I caratteri consentiti sono qualsiasi carattere alfanumerico, un trattino (-) e un carattere di sottolineatura (_). Tutti gli ID per un mercato (vedere contentLanguage e targetCountry) devono essere univoci. Ad esempio, all'interno di un mercato, non è possibile utilizzare PROMO1 e promo1, ma si potrebbe usare PROMO1 nel mercato en-US e promo1 nel mercato en-GB. È possibile specificare lo stesso ID promozione univoco in uno o più prodotti. Microsoft promuove il prodotto se l'ID specificato corrisponde a un ID promozione nel feed Promozioni (per lo stesso paese di destinazione). Gli ID corrispondono solo se la combinazione di maiuscole e minuscole è la stessa. Ad esempio, gli ID corrispondono se l'ID del prodotto è PROMO1 e l'ID del feed è PROMO1, ma non corrispondono se l'ID del feed è Promo1. Per assicurarsi che il prodotto non venga promosso accidentalmente in futuro, è necessario rimuovere gli ID delle promozioni terminate. Anche se l'ID non può essere usato di nuovo in un feed Promozioni per 6 mesi dopo la fine della promozione, se l'ID viene riutilizzato in un'altra promozione, il prodotto verrà promosso.	Stringa	No
salePrice <sale_price>	Prezzo di vendita dell'articolo. Il prezzo di vendita deve essere compreso tra 0,01 (1 cent) e 100000000,00 (10 milioni). Per gli articoli in vendita, impostare sia il prezzo di vendita che la data di validità della vendita (vedere `salePriceEffectiveDate`). Se si imposta il prezzo di vendita ma non la data di validità del prezzo di vendita, il prezzo di vendita continuerà a essere utilizzato fino alla scadenza del prodotto o all'impostazione di una data di validità. Se vengono soddisfatte le condizioni seguenti, è possibile impostare il prezzo di vendita su 0,0 (zero). 1. Il campo googleProductCategory è impostato su una delle categorie seguenti: - Elettronica > Comunicazioni > Telefonia > Cellulare - Computer > elettronici > Tablet Computer 2. Il campo del titolo contiene una delle parole chiave seguenti: -Contratto -Rata -Locazione -Pagamento Le parole chiave precedenti sono visualizzate in inglese; tuttavia, il titolo e la parola chiave devono essere nella lingua del mercato specificato. In genere, il titolo conterrà formulazioni come "... con piano di rata" o "... solo con contratto". La parola chiave contract può essere usata in tutti i mercati; tuttavia, la rata, il pagamento e il lease possono essere usati solo nel mercato statunitense.	ProductPrice	No
salePriceEffectiveDate <sale_price_effective_date>	Data di inizio e fine UTC della vendita. Specificare le date in formato ISO 8601 . Ad esempio, 2016-04-05T08:00-08:00/2016-04-10T19:30-08:00 (usare una barra ('/') per separare le date di inizio e fine). Per ulteriori informazioni, vedere `salePrice`.	Stringa	No
sellerName <seller_name>	Nome del commerciante che vende il prodotto. Usato solo dagli aggregatori per identificare il commerciante. Gli aggregatori sono siti di terze parti che si comportano per conto di singoli commercianti. I prodotti inviati da un aggregatore per conto del commerciante devono essere conformi ai criteri e alle Condizioni per l'utilizzo di Microsoft Advertising. Gli aggregatori devono impostare questo campo sul nome dei venditori. Se il chiamante non è un aggregatore e questo campo non è impostato, verrà impostato per impostazione predefinita sul nome dell'archivio. Il nome è limitato a 255 caratteri.	Stringa	No
Spedizione <Spedizione>	Prezzo per la spedizione del prodotto in base alla posizione. NOTA: la spedizione è necessaria se il paese di destinazione è DE (Germania); in caso contrario, è facoltativo.	ProductShipping[]	Sì
shippingLabel <shipping_label>	Etichetta di spedizione. NOTA: le informazioni di spedizione sono necessarie se il paese di destinazione è DE (Germania); in caso contrario, è facoltativo.	Stringa	Sì
shippingWeight <shipping_weight>	Peso del prodotto. Il peso viene utilizzato per scopi di spedizione. NOTA: le informazioni di spedizione sono necessarie se il paese di destinazione è DE (Germania); in caso contrario, è facoltativo.	ProductShippingWeight	Sì
Dimensioni <Dimensione>	Dimensioni disponibili del prodotto. Ad esempio, piccolo, medio e grande. Applicare il ridimensionamento in modo coerente. Il valore delle dimensioni è definito dall'utente, ma deve essere basato sul paese di destinazione. Questo campo è necessario per tutti i prodotti Apparel & Accessories quando si punta a: Francia, Germania, Regno Unito e Stati Uniti.	String[]	No
sizeSystem <size_system>	Sistema di misurazione utilizzato per dimensionare il prodotto. Ad esempio, le scarpe possono essere ridimensionate usando il sistema degli Stati Uniti o il sistema del Regno Unito. Di seguito sono riportati i valori possibili. AU DE FR Regno unito IT Per impostazione predefinita, viene usato il sistema usato dal paese di destinazione. Consigliato per gli articoli di abbigliamento.	Stringa	No
Sizetype <size_type>	Il taglio del prodotto. Di seguito sono riportati i valori possibili. Regolare Maternità Petite Plus grande e alto Per impostazione predefinita è Normale. Consigliato per gli articoli di abbigliamento.	Stringa	No
targetCountry <target_country>	Il codice paese ISO 3166 di due lettere del paese di destinazione (il paese in cui si vuole pubblicizzare il prodotto). Il paese deve corrispondere al mercato specificato dal catalogo. Di seguito sono riportati i possibili valori senza distinzione tra maiuscole e minuscole: AD (Andorra) AL (Albania) AR (Argentina) AW (Aruba) AT (Austria) AU (Australia) BS (Bahamas) BD (Bangladesh) BA (Bosnia ed Erzegovina) BE (Belgio) BO (Bolivia) BG (Bulgaria) BR (Brasile) BN (Brunei) CA (Canada) KY (Isole Cayman) CH (Svizzera) CL (Cile) CO (Colombia) CR (Costa Rica) CY (Cipro) CZ (Repubblica Ceca) DE (Germania) DK (Danimarca) DM (Dominica) DO (Repubblica Dominicana) EC (Ecuador) SV (El Salvador) EE (Estonia) ES (Spagna) FJ (Figi) FI (Finlandia) FR (Francia) GF (Guyana francese) PF (Polinesia francese) GB (Gran Bretagna) GR (Grecia) GU (Guam) GT (Guatemala) GY (Guyana) HT (Haiti) HN (Honduras) HR (Croazia) HU (Ungheria) ID (Indonesia) Internet Explorer (Irlanda) IN (India) IS (Islanda) IT (Italia) LI (Liechtenstein) LT (Lituania) LU (Lussemburgo) LV (Lettonia) MV (Maldive) MC (Monaco) ME (Montenegro) MK (Macedonia del Nord) MT (Malta) MQ (Martinica) MY (Malaysia) MX (Messico) MN (Mongolia) MS (Montserrat) NP (Nepal) NL (Paesi Bassi) NC (Nuova Caledonia) NO (Norvegia) NZ (Nuova Zelanda) PA (Panama) PG (Papua Nuova Guinea) PH (Filippine) PY (Paraguay) PE (Perù) PL (Polonia) PT (Portogallo) PR (PortoRico) RO (Romania) RS (Serbia) LK (Sri Lanka) SE (Svezia) SG (Singapore) SI (Slovenia) SK (Slovacchia) SM (San Marino) TH (Thailandia) TT (Trinidad e Tobago) TR (Türkiye) Stati Uniti (Stati Uniti) UT (Uruguay) VA (Città del Vaticano) VE (Venezuela) VN (Vietnam) ZA (Sudafrica) Poiché il paese viene usato per creare l'ID prodotto, non è possibile modificare questo campo dopo aver aggiunto il prodotto al negozio.	Stringa	Sì
Tasse <tassa>	Informazioni fiscali del prodotto. MMC non usa questo campo; è incluso per la compatibilità con Google.	ProductTax[]	No
Titolo <Titolo>	Titolo del prodotto ,ad esempio Scarpe da donna. Il titolo potrebbe non includere testo promozionale. Il titolo è limitato a un massimo di 150 caratteri e può includere qualsiasi carattere Unicode. Il titolo sarà sottoposto a revisione editoriale.	Stringa	Sì
unitPricingBaseMeasure <unit_pricing_base_measure>	La misura di base del prodotto per i prezzi (ad esempio, 100ml indica che il prezzo viene calcolato in base a un'unità da 100ml). Peso: oz, lb, mg, g, kg Volume (US imperial): floz, pt, qt, gal Volume: ml, cl, l, cbm Lunghezza: in, ft, yd, cm, m Area: mq, mq Per unità: ct	UnitPricingBaseMeasure	No
unitPricingMeasure <unit_pricing_measure>	Misura e dimensione del prodotto man mano che viene venduto. Peso: oz, lb, mg, g, kg Volume (US imperial): floz, pt, qt, gal Volume: ml, cl, l, cbm Lunghezza: in, ft, yd, cm, m Area: mq, mq Per unità: ct	UnitPricingMeasure	No
validatedDestinations <validated_destination>	Elenco di sola lettura delle destinazioni previste che hanno superato la convalida. MMC non usa questo campo; è incluso per la compatibilità con Google.	String[]	No
Avvertenze	Elenco di avvisi relativi ai problemi relativi all'offerta del prodotto. L'offerta è stata accettata, ma è consigliabile risolvere i problemi al più presto. Ad esempio, MMC restituisce avvisi se non si specificano gli identificatori gtin, mpn e del marchio , se devono essere noti. L'offerta include questo campo solo nella risposta di un inserimento/aggiornamento.	Avviso[]	No

ProductCustomAttribute

Definisce un attributo personalizzato.

Name	Valore	Tipo	Nome elemento XML
Nome	Ottiene o imposta il nome dell'attributo.	Stringa	<Nome>
tipo	Ottiene o imposta il tipo dell'attributo. Di seguito sono riportati i valori possibili. booleano datetimerange Galleggiante group int Prezzo testo Tempo Url	Stringa	<digitare>
Unità	Ottiene o imposta l'unità di misura dell'attributo. Utilizzato solo per i valori di tipo INT e FLOAT.	Stringa	<Unità>
valore	Ottiene o imposta il valore dell'attributo.	Stringa	<Valore>

ProductCustomGroup

Definisce un gruppo di attributi del cliente.

Name	Valore	Tipo	Nome elemento XML
Attributi	Ottiene o imposta gli attributi per il gruppo.	ProductCustomAttribute	<Attributi>
Nome	Ottiene o imposta il nome del gruppo.	Stringa	<Nome>

ProductDestination

Definisce una destinazione.

Name	Valore	Tipo	Nome elemento XML
Intenzione	Di seguito sono riportati i valori possibili. Predefinito Escluso Opzionale Obbligatorio	Stringa	<Intenzione>
destinationName	Ottiene o imposta il nome della destinazione.	Stringa	<destination_name>

ProductPrice

Definisce il prezzo o il prezzo di vendita di un prodotto.

Name	Valore	Tipo	Nome elemento XML
Valuta	Ottiene o imposta la valuta in cui è indicato il prezzo. Specificare la valuta usando i codici di valuta ISO 4217. Di seguito sono riportati i valori possibili. AUD (dollaro australiano) CHF (franco svizzero) CAD (dollaro canadese) EUR (Euro) GBP (Gran Bretagna) IDR (rupia indonesiana) INR (rupia indiana) MYR (ringgit malese) NZD (Dollaro nuova Zelanda) PHP (Peso delle Filippine) SEK (corona svedese) SGD (dollaro di Singapore) THB (thai baht) USD (Stati Uniti dollaro) VND (dong vietnamita)	Stringa	`currency` Attributo. Ad esempio, <price currency="USD">.
valore	Ottiene o imposta il prezzo dell'articolo. Non includere simboli di valuta come '$'.	Double	Valore di testo. Ad esempio, <price currency="USD">38,0<\price>.

Prodotti

Definisce un elenco di prodotti. Si noti che questo è l'oggetto di primo livello restituito dalla richiesta List.

Name	Valore	Tipo	Nome elemento XML
gentile	Ottiene il tipo dell'oggetto. Questo campo è impostato su content#productsListResponse.	Stringa	<gentile>
nextPageToken	Ottiene il token utilizzato per ottenere la pagina successiva dei risultati. Se l'oggetto non include questo campo, non ci sono più pagine da ottenere. Vedere start-token.	Stringa	<next_page_token>
Risorse	Ottiene l'elenco di prodotti. Se il catalogo non contiene offerte, la matrice è vuota.	Product[]	<Prodotti>

ProductShipping

Definisce il costo di spedizione.

Name	Valore	Tipo	Nome elemento XML
Paese	Ottiene o imposta il codice paese ISO 3166 di due lettere del paese in cui viene spedito l'articolo.	Stringa	<Paese>
locationGroupName	Ottiene o imposta il nome del gruppo di posizioni.	Stringa	<location_group_name>
locationId	Ottiene o imposta l'ID della posizione geografica in cui viene spedito l'elemento. Per un elenco degli ID, vedere Codici di posizione geografica.	Stringa	<location_id>
Postalcode	Ottiene o imposta il codice postale o l'intervallo di codici postali della località in cui viene spedito l'articolo. È possibile specificare il codice postale come indicato di seguito: Un codice postale completo: 94114 Codice postale con carattere jolly (solo suffisso): 94* Un intervallo di codici: 94002-95460 Un intervallo di codici con caratteri jolly (i prefissi del codice postale devono avere la stessa lunghezza: 94-95	Stringa	<Postal_code>
Prezzo	Ottiene o imposta il prezzo fisso per spedire l'articolo alla posizione specificata.	ProductPrice	<Prezzo>
Regione	Ottiene o imposta l'area geografica in cui viene spedito l'elemento, ad esempio il codice postale.	Stringa	<Regione>
servizio	Ottiene o imposta una descrizione di testo che descrive la classe di servizio o la velocità di recapito.	Stringa	<Servizio>

ProductShippingWeight

Definisce il peso di spedizione dell'elemento.

Name	Valore	Tipo	Nome elemento XML
Unità	Ottiene o imposta l'unità di misura.	Stringa	`unit` Attributo. Ad esempio, <shipping_weight unit="oz">.
valore	Ottiene o imposta il peso dell'articolo, utilizzato per calcolare il costo di spedizione dell'articolo.	Stringa	Valore di testo. Ad esempio, <shipping_weight unit="oz">20,3<shipping_weight>.

ProductTax

Definisce la posizione geografica che determina le imposte applicabili.

Name	Valore	Tipo	Nome elemento XML
Paese	Ottiene o imposta il paese di cui viene applicata l'aliquota fiscale. Usa il codice paese ISO 3166 a due lettere.	Stringa	<Paese>
locationId	Ottiene o imposta l'ID della posizione geografica di cui viene applicata l'aliquota d'imposta. Per un elenco degli ID, vedere Codici di posizione geografica.	Lungo	<location_id>
Postalcode	Ottiene o imposta il codice postale o l'intervallo di codici postali di cui viene applicata l'aliquota d'imposta. È possibile specificare il codice postale come indicato di seguito: Un codice postale completo: 94114 Codice postale con carattere jolly (solo suffisso): 94* Un intervallo di codici: 94002-95460 Un intervallo di codici con caratteri jolly (i prefissi del codice postale devono avere la stessa lunghezza: 94-95	Stringa	<Postal_code>
Tasso	Ottiene o imposta l'aliquota iva percentuale da applicare al prezzo dell'articolo. Per specificare una tariffa del 5%, impostare questo campo su 5. Per specificare una tariffa del 9,8%, impostare questo campo su 9,8.	Double	<Tasso>
Regione	Ottiene o imposta un'area geografica la cui aliquota fiscale si applica.	Stringa	<Regione>
taxShip	Ottiene o imposta un valore booleano che determina se applicare l'imposta al costo della spedizione. Impostare su true se l'imposta viene addebitata sulla spedizione.	Booleano	<Nave>

UnitPricing

Definisce il prezzo unitario dell'articolo.

Name	Valore	Tipo	Nome elemento XML
Unità	Ottiene o imposta l'unità di misura. Ad esempio, oz se il prezzo è per oncia.	Stringa	`unit` Attributo. Ad esempio, <unit_pricing_measure unit="oz">
valore	Ottiene o imposta il prezzo per unità.	Double	Valore di testo. Ad esempio, <unit_pricing_measure unit="oz">34,5<\unit_pricing_measure>

Avviso

Definisce un messaggio di avviso.

Name	Valore	Tipo	Nome elemento XML
dominio	Solo per uso interno.	Stringa	<Dominio>
messaggio	Descrizione dell'avviso.	Stringa	<internalReason>
motivo	Motivo per cui l'offerta ha generato un avviso. Ad esempio, non è stato specificato un identificatore (gtin, mpn o marchio) quando il produttore è noto per averli assegnati.	Stringa	<Motivo>

Codici di stato HTTP

Le richieste possono restituire i codici di stato HTTP seguenti.

Codice di stato	Descrizione
200	Completato.
204	Il prodotto è stato eliminato correttamente.
400	Richiesta non valida. Un valore del parametro di query non è valido o un elemento nel corpo della richiesta non è valido. Batch: se si verifica un errore, l'elemento batch non riuscito includerà gli errori.
401	Non autorizzato. Le credenziali dell'utente non sono valide.
404	Non trovato.
409	Conflitto. Impossibile completare l'operazione a causa di un conflitto con lo stato corrente della risorsa.
413	Entità richiesta troppo grande. Le dimensioni della richiesta superano il massimo consentito.
500	Errore del server.

Condividi tramite