Indice
ProductInputsService
(interfaccia)ProductsService
(interfaccia)Attributes
(messaggio)Certification
(messaggio)CloudExportAdditionalProperties
(messaggio)DeleteProductInputRequest
(messaggio)FreeShippingThreshold
(messaggio)GetProductRequest
(messaggio)InsertProductInputRequest
(messaggio)Installment
(messaggio)ListProductsRequest
(messaggio)ListProductsResponse
(messaggio)LoyaltyPoints
(messaggio)LoyaltyProgram
(messaggio)Product
(messaggio)ProductDetail
(messaggio)ProductDimension
(messaggio)ProductInput
(messaggio)ProductStatus
(messaggio)ProductStatus.DestinationStatus
(messaggio)ProductStatus.ItemLevelIssue
(messaggio)ProductStatus.ItemLevelIssue.Severity
(enum)ProductStructuredDescription
(messaggio)ProductStructuredTitle
(messaggio)ProductSustainabilityIncentive
(messaggio)ProductSustainabilityIncentive.Type
(enum)ProductWeight
(messaggio)Shipping
(messaggio)ShippingDimension
(messaggio)ShippingWeight
(messaggio)SubscriptionCost
(messaggio)SubscriptionPeriod
(enum)Tax
(messaggio)UnitPricingBaseMeasure
(messaggio)UnitPricingMeasure
(messaggio)
ProductInputsService
Servizio per utilizzare la risorsa ProductInput. Questo servizio è disponibile solo per i prodotti con canale online.
DeleteProductInput |
---|
Consente di eliminare un input del prodotto dal tuo account Merchant Center. Dopo aver inserito, aggiornato o eliminato un input del prodotto, potrebbero essere necessari diversi minuti prima che il prodotto elaborato possa essere recuperato.
|
InsertProductInput |
---|
Carica un input prodotto nel tuo account Merchant Center. Se esiste già un input con gli stessi valori contentLanguage, offerId e dataSource, questo metodo sostituisce la voce. Dopo aver inserito, aggiornato o eliminato un input del prodotto, potrebbero essere necessari diversi minuti prima che il prodotto elaborato possa essere recuperato.
|
Servizio prodotti
Servizio per utilizzare la risorsa Prodotto. Questo servizio è disponibile solo per i prodotti con canale online.
GetProduct |
---|
Recupera il prodotto elaborato dal tuo account Merchant Center. Dopo aver inserito, aggiornato o eliminato un input del prodotto, potrebbero essere necessari diversi minuti prima che il prodotto finale aggiornato possa essere recuperato.
|
ListProducts |
---|
Elenca i prodotti elaborati nel tuo account Merchant Center. La risposta potrebbe contenere meno elementi rispetto a quanto specificato da pageSize. Utilizza pageToken per determinare se ci sono altri elementi da richiedere. Dopo aver inserito, aggiornato o eliminato un input del prodotto, potrebbero essere necessari diversi minuti prima che il prodotto elaborato aggiornato possa essere recuperato.
|
Attributi
Attributi.
Campi | |
---|---|
additional_ |
URL aggiuntivi di immagini dell'articolo. |
expiration_ |
Data di scadenza dell'articolo, come specificato al momento dell'inserimento, in formato ISO 8601. La data di scadenza effettiva è esposta in |
disclosure_ |
La data e l'ora in cui un'offerta diventa visibile nei risultati di ricerca sulle piattaforme YouTube di Google, nel formato ISO 8601. Per ulteriori informazioni, consulta la [data di divulgazione]( https://support.google.com/merchants/answer/13034208). |
availability_ |
Il giorno in cui il prodotto pre-ordinato diventa disponibile per la consegna, in formato ISO 8601. |
gtin[] |
I codici Global Trade Item Number (GTIN) dell'articolo. Puoi fornire fino a 10 GTIN. |
price |
Prezzo dell'articolo. |
installment |
Numero e importo delle rate da pagare per un articolo. |
subscription_ |
Numero di periodi (mesi o anni) e importo del pagamento per periodo per un articolo con un contratto di abbonamento associato. |
loyalty_ |
Punti fedeltà che gli utenti ricevono dopo l'acquisto dell'articolo. Solo in Giappone. |
loyalty_ |
Un elenco di informazioni sul programma fedeltà utilizzato per mostrare i vantaggi del programma fedeltà (ad esempio prezzi migliori, punti e così via) all'utente di questo articolo. |
product_ |
Categorie dell'articolo (formattate come nella specifica dei dati di prodotto). |
sale_ |
Prezzo scontato pubblicizzato dell'articolo. |
sale_ |
Intervallo di date durante il quale l'articolo è in saldo (vedi specifica dei dati di prodotto). |
product_ |
L'altezza del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 3000 (incluso). |
product_ |
La lunghezza del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 3000 (incluso). |
product_ |
La larghezza del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 3000 (incluso). |
product_ |
Il peso del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 2000 (incluso). |
shipping[] |
Regole di spedizione. |
free_ |
Condizioni da soddisfare per poter usufruire della spedizione gratuita per un prodotto. |
shipping_ |
Peso dell'articolo per la spedizione. |
shipping_ |
Lunghezza dell'articolo per la spedizione. |
shipping_ |
Larghezza dell'articolo per la spedizione. |
shipping_ |
Altezza dell'articolo per la spedizione. |
size_ |
Il taglio dell'articolo. Può essere utilizzato per rappresentare tipi di taglie combinate per articoli di abbigliamento. Puoi fornire al massimo due tipi di taglia (vedi [https://support.google.com/merchants/answer/6324497](tipo di taglia)). |
taxes[] |
Dati fiscali. |
unit_ |
La misura e la dimensione di un articolo. |
unit_ |
La preferenza del denominatore del prezzo unitario. |
ads_ |
Simile ad ads_grouping, ma funziona solo con il CPC. |
cost_ |
Costo del venduto. Utilizzato per i report sul margine lordo. |
product_ |
Specifiche tecniche o dettagli aggiuntivi del prodotto. |
product_ |
Punti elenco che descrivono le caratteristiche più pertinenti di un prodotto. |
display_ |
Consigli specificati dall'inserzionista. |
promotion_ |
L'ID univoco di una promozione. |
included_ |
L'elenco delle destinazioni da includere per questo target (corrisponde alle caselle di controllo selezionate in Merchant Center). Le destinazioni predefinite sono sempre incluse, a meno che non siano fornite in |
excluded_ |
L'elenco delle destinazioni da escludere per questo target (corrisponde alle caselle di controllo non selezionate in Merchant Center). |
shopping_ |
Elenco dei codici paese (ISO 3166-1 alpha-2) per escludere l'offerta dalla destinazione degli annunci Shopping. I paesi in questo elenco vengono rimossi dai paesi configurati nelle impostazioni dell'origine dati. |
lifestyle_ |
URL aggiuntivi di immagini lifestyle dell'articolo, utilizzati per identificare esplicitamente le immagini che mostrano l'articolo in un contesto reale. Per ulteriori informazioni, consulta questo articolo del Centro assistenza. |
cloud_ |
Campi aggiuntivi da esportare nel programma Cloud per la vendita al dettaglio. |
certifications[] |
Certificazioni dei prodotti, ad esempio per l'etichettatura energetica dei prodotti registrati nel database EPREL dell'UE. Per ulteriori informazioni, consulta l'articolo del Centro assistenza. |
auto_ |
Una salvaguardia nei progetti "Sconti automatici" (https://support.google.com/merchants/answer/10295759) e "Promozioni dinamiche" (https://support.google.com/merchants/answer/13949249) che garantisce che gli sconti sulle offerte dei commercianti non scendano al di sotto di questo valore, preservando così il valore e la redditività dell'offerta. |
sustainability_ |
L'elenco dei programmi di incentivi per la sostenibilità. |
identifier_ |
Imposta questo valore su false quando l'articolo non ha codici identificativi di prodotto appropriati alla sua categoria, come GTIN, MPN e marca. Se non viene fornito, il valore predefinito è true. |
is_ |
Indica se l'articolo è un set definito dal commerciante. Un set è un raggruppamento personalizzato di diversi prodotti venduti da un commerciante a un unico prezzo. |
title |
Titolo dell'articolo. |
description |
Descrizione dell'articolo. |
link |
URL che rimanda direttamente alla pagina dell'articolo nel tuo negozio online. |
mobile_ |
URL della versione ottimizzata per il mobile della pagina di destinazione dell'articolo. |
canonical_ |
URL della versione canonica della pagina di destinazione dell'articolo. |
image_ |
URL di un'immagine dell'articolo. |
adult |
Impostato su true se l'articolo è destinato agli adulti. |
age_ |
Fascia d'età target dell'articolo. |
availability |
Stato di disponibilità dell'articolo. |
brand |
Marca dell'articolo. |
color |
Colore dell'articolo. |
condition |
Condizione o stato dell'articolo. |
gender |
Genere target dell'articolo. |
google_ |
La categoria dell'articolo di Google (vedi Tassonomia dei prodotti Google). Quando esegui una query sui prodotti, questo campo conterrà il valore fornito dall'utente. Al momento non è possibile recuperare le categorie di prodotto Google assegnate automaticamente tramite l'API. |
item_ |
Identificatore comune a tutte le varianti di uno stesso prodotto. |
material |
Il materiale di cui è composto l'articolo. |
mpn |
Il codice parte produttore (MPN) dell'articolo. |
pattern |
Il motivo dell'articolo (ad esempio, a pois). |
sell_ |
La quantità di prodotto disponibile per la vendita su Google. Supportato solo per i prodotti online. |
max_ |
Tempo di elaborazione massimo del prodotto (in giorni lavorativi). |
min_ |
Tempo di elaborazione minimo del prodotto (in giorni lavorativi). |
shipping_ |
L'etichetta di spedizione del prodotto, utilizzata per raggruppare il prodotto nelle regole di spedizione a livello di account. |
transit_ |
L'etichetta del tempo di transito del prodotto, utilizzata per raggruppare i prodotti nelle tabelle dei tempi di transito a livello di account. |
size |
Taglia dell'articolo. È consentito un solo valore. Per le varianti con taglie diverse, inserisci un prodotto separato per ogni taglia con lo stesso valore |
size_ |
Sistema in cui è specificata la taglia. Consigliato per gli articoli di abbigliamento. |
tax_ |
La categoria fiscale del prodotto. |
energy_ |
La classe energetica come definita dalla direttiva UE 2010/30/UE. |
min_ |
La classe energetica come definita nella direttiva UE 2010/30/UE. |
max_ |
La classe energetica come definita dalla direttiva UE 2010/30/UE. |
multipack |
Il numero di prodotti identici in un multipack definito dal commerciante. |
ads_ |
Utilizzato per raggruppare gli articoli in modo arbitrario. Solo per il CPA%; sconsigliato in caso contrario. |
ads_ |
Consente agli inserzionisti di sostituire l'URL dell'articolo quando il prodotto viene mostrato nel contesto degli annunci di prodotto. |
display_ |
L'identificatore di un articolo per le campagne di remarketing dinamico. |
display_ |
Titolo di un articolo per le campagne di remarketing dinamico. |
display_ |
URL che rimanda direttamente alla pagina di destinazione dell'articolo per le campagne di remarketing dinamico. |
display_ |
Margine di offerta per le campagne di remarketing dinamico. |
pickup_ |
L'opzione di ritiro dell'articolo. |
pickup_ |
Tempistiche per il ritiro dell'articolo in negozio. |
link_ |
Modello link per la vetrina locale ospitata dal commerciante. |
mobile_ |
Modello di link per la vetrina locale ospitata dal commerciante ottimizzata per i dispositivi mobili. |
custom_ |
Etichetta personalizzata 0 per il raggruppamento personalizzato degli articoli in una campagna Shopping. |
custom_ |
Etichetta personalizzata 1 per il raggruppamento personalizzato degli articoli in una campagna Shopping. |
custom_ |
Etichetta personalizzata 2 per il raggruppamento personalizzato degli articoli in una campagna Shopping. |
custom_ |
Etichetta personalizzata 3 per il raggruppamento personalizzato degli articoli in una campagna Shopping. |
custom_ |
Etichetta personalizzata 4 per il raggruppamento personalizzato degli elementi in una campagna Shopping. |
external_ |
Obbligatorio per gli account multi-venditore. Utilizza questo attributo se sei un marketplace che carica prodotti per vari venditori nel tuo account multi-venditore. |
pause |
La pubblicazione di questo articolo verrà messa in pausa temporaneamente. |
virtual_ |
URL dell'immagine 3D dell'articolo. Per ulteriori informazioni, consulta questo articolo del Centro assistenza. |
structured_ |
Titolo strutturato, per i titoli creati con l'algoritmo (IA). |
structured_ |
Descrizione strutturata, per le descrizioni generate con un algoritmo (IA). |
Certificazione
Certificazione del prodotto, inizialmente introdotta per la conformità all'etichettatura energetica dell'UE utilizzando il database EPREL dell'UE.
Campi | |
---|---|
certification_ |
L'autorità di certificazione, ad esempio "European_Commission". La lunghezza massima è di 2000 caratteri. |
certification_ |
Il nome della certificazione, ad esempio "EPREL". La lunghezza massima è di 2000 caratteri. |
certification_ |
Il codice di certificazione. La lunghezza massima è di 2000 caratteri. |
certification_ |
Il valore della certificazione (noto anche come classe, livello o voto), ad esempio "A+", "C", "oro". La lunghezza massima è di 2000 caratteri. |
CloudExportAdditionalProperties
Proprietà del prodotto per l'API Cloud Retail. Ad esempio, le proprietà per un prodotto TV potrebbero essere "Screen-Resolution" o "Screen-Size".
Campi | |
---|---|
text_ |
Valore di testo della proprietà specificata. Ad esempio, "8K(UHD)" potrebbe essere un valore di testo per un prodotto TV. La ripetizione massima di questo valore è 400. I valori vengono memorizzati in un ordine arbitrario, ma coerente. La dimensione massima della stringa è di 256 caratteri. |
int_ |
Valori interi della proprietà specificata. Ad esempio, 1080 per la risoluzione dello schermo di un prodotto TV. La ripetizione massima di questo valore è 400. I valori vengono memorizzati in un ordine arbitrario, ma coerente. |
float_ |
Valori in virgola mobile della proprietà specificata. Ad esempio, per un prodotto TV 1.2345. La ripetizione massima di questo valore è 400. I valori vengono memorizzati in un ordine arbitrario, ma coerente. |
property_ |
Nome della proprietà specificata. Ad esempio, "Screen-Resolution" per un prodotto TV. La dimensione massima della stringa è di 256 caratteri. |
bool_ |
Valore booleano della proprietà specificata. Ad esempio, per un prodotto TV, "True" o "False" se lo schermo è UHD. |
min_ |
Valore minimo del tipo float della proprietà specificata. Ad esempio, per un prodotto TV 1.00. |
max_ |
Valore massimo in virgola mobile della proprietà specificata. Ad esempio, 100,00 € per un prodotto TV. |
unit_ |
Unità della proprietà specificata. Ad esempio, "Pixel" per un prodotto TV. La dimensione massima della stringa è 256 B. |
DeleteProductInputRequest
Messaggio di richiesta per il metodo DeleteProductInput.
Campi | |
---|---|
name |
Obbligatorio. Il nome della risorsa di input del prodotto da eliminare. Formato: accounts/{account}/productInputs/{product}, dove l'ultima sezione |
data_ |
Obbligatorio. L'origine dati principale o supplementare da cui deve essere eliminato l'input del prodotto. Formato: |
FreeShippingThreshold
Condizioni da soddisfare per poter usufruire della spedizione gratuita per un prodotto.
Campi | |
---|---|
country |
Il codice di territorio CLDR del paese in cui verrà spedito un articolo. |
price_ |
Il prezzo minimo del prodotto per cui il costo di spedizione diventa senza costi. Rappresentato come numero. |
GetProductRequest
Messaggio di richiesta per il metodo GetProduct.
Campi | |
---|---|
name |
Obbligatorio. Il nome del prodotto da recuperare. Formato: |
InsertProductInputRequest
Messaggio di richiesta per il metodo InsertProductInput.
Campi | |
---|---|
parent |
Obbligatorio. L'account in cui verrà inserito questo prodotto. Formato: accounts/{account} |
product_ |
Obbligatorio. L'input del prodotto da inserire. |
data_ |
Obbligatorio. Il nome dell'origine dati di prodotto principale o supplementare. Se il prodotto esiste già e l'origine dati fornita è diversa, il prodotto verrà spostato in una nuova origine dati. Sono supportate solo le origini dati API. Formato: |
Rata
Un messaggio che rappresenta la rata.
Campi | |
---|---|
months |
Il numero di rate che l'acquirente deve pagare. |
amount |
L'importo che l'acquirente deve pagare ogni mese. |
downpayment |
L'importo dell'acconto anticipato che l'acquirente deve pagare. |
credit_ |
Tipo di pagamenti rateali. I valori supportati sono: * " |
ListProductsRequest
Messaggio di richiesta per il metodo ListProducts.
Campi | |
---|---|
parent |
Obbligatorio. L'account per cui elencare i prodotti elaborati. Formato: accounts/{account} |
page_ |
Il numero massimo di prodotti da restituire. Il servizio potrebbe restituire meno di questo valore. Il valore massimo è 250; i valori superiori a 250 verranno forzati a 250. Se non specificato, verrà restituito il numero massimo di prodotti. |
page_ |
Un token di pagina ricevuto da una chiamata Quando viene applicata la paginazione, tutti gli altri parametri forniti a |
ListProductsResponse
Messaggio di risposta per il metodo ListProducts.
Campi | |
---|---|
products[] |
I prodotti elaborati dall'account specificato. Si tratta dei prodotti elaborati dopo l'applicazione di regole e origini dati supplementari. |
next_ |
Un token che può essere inviato come |
LoyaltyPoints
Un messaggio che rappresenta i punti fedeltà.
Campi | |
---|---|
name |
Nome del programma fedeltà a punti. Si consiglia di limitare il nome a 12 caratteri standard o 24 caratteri romani. |
points_ |
I punti fedeltà del rivenditore in valore assoluto. |
ratio |
Il rapporto di un punto se convertito in valuta. Google presume la valuta in base alle impostazioni di Merchant Center. Se il rapporto non viene specificato, il valore predefinito è 1,0. |
LoyaltyProgram
Un messaggio che rappresenta il programma fedeltà.
Campi | |
---|---|
program_ |
L'etichetta del programma fedeltà. Si tratta di un'etichetta interna che identifica in modo univoco la relazione tra un'entità commerciante e un'entità del programma fedeltà. L'etichetta deve essere fornita in modo che il sistema possa associare gli asset riportati di seguito (ad esempio prezzo e punti) a un commerciante. Il programma corrispondente deve essere collegato all'account commerciante. |
tier_ |
L'etichetta del livello all'interno del programma fedeltà. Deve corrispondere a una delle etichette all'interno del programma. |
price |
Il prezzo per i membri del livello specificato, ovvero il prezzo scontato istantaneo. Deve essere inferiore o uguale al prezzo normale. |
cashback_ |
Il cashback che può essere utilizzato per acquisti futuri. |
loyalty_ |
L'importo dei punti fedeltà guadagnati con un acquisto. |
member_ |
Un intervallo di date durante il quale l'articolo è idoneo per il prezzo riservato agli abbonati. Se non specificato, viene sempre applicato il prezzo per i membri. L'intervallo di date è rappresentato da una coppia di date ISO 8601 separate da uno spazio, una virgola o una barra. |
shipping_ |
L'etichetta del vantaggio della spedizione. Se il campo ha un valore, questa offerta prevede il vantaggio della spedizione previsto dal programma fedeltà. Se il valore del campo non viene fornito, l'articolo non è idoneo per la spedizione prevista dal programma fedeltà per il livello di fedeltà specificato. |
Prodotto
Il prodotto elaborato, creato da più product inputs
dopo l'applicazione di regole e origini dati supplementari. Questo prodotto elaborato corrisponde a quello mostrato nel tuo account Merchant Center, negli annunci Shopping e su altre piattaforme Google. Ogni prodotto viene creato da un input prodotto dell'origine dati principale e da più input dell'origine dati supplementare. Dopo aver inserito, aggiornato o eliminato un input del prodotto, potrebbero essere necessari diversi minuti prima che il prodotto elaborato aggiornato possa essere recuperato.
Tutti i campi del prodotto elaborato e dei relativi messaggi secondari corrispondono al nome dell'attributo corrispondente nella specifica dei dati di prodotto, con alcune eccezioni.
Campi | |
---|---|
name |
Il nome del prodotto. Formato: |
channel |
Solo output. Il canale del prodotto. |
offer_ |
Solo output. Il tuo identificatore univoco per il prodotto. Lo stesso vale per il prodotto inserito e per il prodotto elaborato. Gli spazi vuoti iniziali e finali vengono rimossi e più spazi vengono sostituiti da un singolo spazio al momento dell'invio. Per maggiori dettagli, consulta la specifica dei dati di prodotto. |
content_ |
Solo output. Il codice lingua ISO 639-1 di due lettere del prodotto. |
feed_ |
Solo output. L'etichetta del feed per il prodotto. |
data_ |
Solo output. L'origine dati principale del prodotto. |
attributes |
Solo output. Un elenco di attributi del prodotto. |
custom_ |
Solo output. Un elenco di attributi personalizzati (forniti dal commerciante). Può essere utilizzato anche per inviare qualsiasi attributo della specifica dei dati nella sua forma generica (ad es. |
product_ |
Solo output. Lo stato di un prodotto, i problemi di convalida dei dati, ovvero le informazioni su un prodotto calcolate in modo asincrono. |
version_ |
Solo output. Rappresenta la versione esistente (aggiornamento) del prodotto, che può essere utilizzata per mantenere l'ordine corretto quando vengono eseguiti più aggiornamenti contemporaneamente. Se impostato, l'inserimento viene impedito quando il numero di versione è inferiore al numero di versione corrente del prodotto esistente. Il nuovo inserimento (ad esempio l'aggiornamento del prodotto dopo 30 giorni) può essere eseguito con l' Supportato solo per le inserzioni nelle origini dati principali. Se l'operazione viene impedita, verrà lanciata l'eccezione di interruzione. |
ProductDetail
I dettagli del prodotto.
Campi | |
---|---|
section_ |
La sezione di intestazione utilizzata per raggruppare un insieme di dettagli del prodotto. |
attribute_ |
Il nome del dettaglio del prodotto. |
attribute_ |
Il valore del dettaglio del prodotto. |
ProductDimension
La dimensione del prodotto.
Campi | |
---|---|
value |
Obbligatorio. Il valore della dimensione rappresentato come numero. Il valore può avere una precisione massima di quattro cifre decimali. |
unit |
Obbligatorio. Le unità di misura delle dimensioni. I valori accettati sono: * " |
ProductInput
Questa risorsa rappresenta i dati di input inviati per un prodotto, non il prodotto elaborato visualizzato in Merchant Center, negli annunci Shopping o sulle piattaforme Google. Gli input dei prodotti, le regole e i dati dell'origine dati supplementare vengono combinati per creare Product
elaborato.
Gli attributi di input dei prodotti richiesti per superare i controlli di convalida dei dati sono definiti principalmente nella specifica dei dati di prodotto.
I seguenti attributi sono obbligatori: feedLabel
, contentLanguage
e offerId
.
Dopo aver inserito, aggiornato o eliminato un input del prodotto, potrebbero essere necessari alcuni minuti prima che il prodotto elaborato possa essere recuperato.
Tutti i campi dell'input del prodotto e dei relativi messaggi secondari corrispondono al nome in inglese del relativo attributo nella specifica verticale, con alcune eccezioni.
Campi | |
---|---|
name |
Identificatore. Il nome dell'input del prodotto. Formato: |
product |
Solo output. Il nome del prodotto trasformato. Formato: |
channel |
Immutabile. Il canale del prodotto. |
offer_ |
Obbligatorio. Immutabile. Il tuo identificatore univoco per il prodotto. Lo stesso vale per il prodotto inserito e per il prodotto elaborato. Gli spazi vuoti iniziali e finali vengono rimossi e più spazi vengono sostituiti da un singolo spazio al momento dell'invio. Per maggiori dettagli, consulta la specifica dei dati di prodotto. |
content_ |
Obbligatorio. Immutabile. Il codice lingua ISO 639-1 di due lettere del prodotto. |
feed_ |
Obbligatorio. Immutabile. L'etichetta del feed per il prodotto. |
attributes |
Facoltativo. Un elenco di attributi del prodotto. |
custom_ |
Facoltativo. Un elenco di attributi personalizzati (forniti dal commerciante). Può essere utilizzato anche per inviare qualsiasi attributo della specifica dei dati nella sua forma generica (ad es. |
version_ |
Facoltativo. Rappresenta la versione esistente (aggiornamento) del prodotto, che può essere utilizzata per mantenere l'ordine corretto quando vengono eseguiti più aggiornamenti contemporaneamente. Se impostato, l'inserimento viene impedito quando il numero di versione è inferiore al numero di versione corrente del prodotto esistente. Il nuovo inserimento (ad esempio l'aggiornamento del prodotto dopo 30 giorni) può essere eseguito con l' Supportato solo per le inserzioni nelle origini dati principali. Se l'operazione viene impedita, verrà lanciata l'eccezione di interruzione. |
ProductStatus
Lo stato di un prodotto, i problemi di convalida dei dati, ovvero le informazioni su un prodotto calcolate in modo asincrono.
Campi | |
---|---|
destination_ |
Le destinazioni previste per il prodotto. |
item_ |
Un elenco di tutti i problemi associati al prodotto. |
creation_ |
Data di creazione dell'elemento, nel formato ISO 8601. |
last_ |
Data dell'ultimo aggiornamento dell'elemento, in formato ISO 8601. |
google_ |
Data di scadenza dell'articolo, in formato ISO 8601. |
DestinationStatus
Lo stato di destinazione dello stato del prodotto.
Campi | |
---|---|
reporting_ |
Il nome del contesto report. |
approved_ |
Elenco dei codici paese (ISO 3166-1 alpha-2) in cui l'offerta è approvata. |
pending_ |
Elenco dei codici paese (ISO 3166-1 alpha-2) in cui l'offerta è in attesa di approvazione. |
disapproved_ |
Elenco dei codici paese (ISO 3166-1 alpha-2) in cui l'offerta non è approvata. |
ItemLevelIssue
Il problema a livello di articolo dello stato del prodotto.
Campi | |
---|---|
code |
Il codice di errore del problema. |
severity |
In che modo questo problema influisce sulla pubblicazione dell'offerta. |
resolution |
Indica se il problema può essere risolto dal commerciante. |
attribute |
Il nome dell'attributo, se il problema è causato da un singolo attributo. |
reporting_ |
Il contesto dei report a cui si applica il problema. |
description |
Una breve descrizione del problema in inglese. |
detail |
Una descrizione dettagliata del problema in inglese. |
documentation |
L'URL di una pagina web che possa aiutarci a risolvere il problema. |
applicable_ |
Elenco dei codici paese (ISO 3166-1 alpha-2) in cui il problema si applica all'offerta. |
Gravità
In che modo il problema influisce sulla pubblicazione del prodotto.
Enum | |
---|---|
SEVERITY_UNSPECIFIED |
Non specificato. |
NOT_IMPACTED |
Questo problema rappresenta un avviso e non ha un impatto diretto sul prodotto. |
DEMOTED |
Il prodotto viene retrocesso e molto probabilmente avrà un rendimento limitato nei risultati di ricerca |
DISAPPROVED |
Il problema non approva il prodotto. |
ProductStructuredDescription
Descrizione strutturata, per le descrizioni generate con un algoritmo (IA).
Campi | |
---|---|
digital_ |
Il tipo di origine digitale, ad esempio "trained_algorithmic_media". Secondo le specifiche IPTC. La lunghezza massima è di 40 caratteri. |
content |
La lunghezza massima del testo della descrizione è di 5000 caratteri |
ProductStructuredTitle
Titolo strutturato, per i titoli creati con l'algoritmo (IA).
Campi | |
---|---|
digital_ |
Il tipo di origine digitale, ad esempio "trained_algorithmic_media". Secondo le specifiche IPTC. La lunghezza massima è di 40 caratteri. |
content |
La lunghezza massima del testo del titolo è di 150 caratteri |
ProductSustainabilityIncentive
Informazioni su programmi di incentivi legati alla sostenibilità, come rimborsi o esenzioni fiscali.
Campi | |
---|---|
Campo unione value . Valore dell'incentivo per la sostenibilità. value può essere solo uno dei seguenti: |
|
amount |
L'importo fisso dell'incentivo. |
percentage |
La percentuale del prezzo scontato a cui si applica lo sconto. |
type |
Programma di incentivi per la sostenibilità. |
Tipo
Tipi di programmi di incentivi per la sostenibilità supportati.
Enum | |
---|---|
TYPE_UNSPECIFIED |
Tipo di incentivo alla sostenibilità non specificato o sconosciuto. |
EV_TAX_CREDIT |
Programma che offre riduzioni dell'onere fiscale per i veicoli elettrici e, in alcuni paesi, per quelli ibridi plug-in. Queste riduzioni possono essere basate su un importo specifico o su una percentuale del prezzo scontato. |
EV_PRICE_DISCOUNT |
Un programma di sussidi, spesso chiamato bonus ambientale, prevede una sovvenzione all'acquisto di veicoli elettrici e, in alcuni paesi, ibridi plug-in. L'importo del contributo può essere una somma fissa o una percentuale del prezzo di vendita. |
ProductWeight
Il peso del prodotto.
Campi | |
---|---|
value |
Obbligatorio. La ponderazione rappresentata come numero. Il peso può avere una precisione massima di quattro cifre decimali. |
unit |
Obbligatorio. L'unità di peso. I valori accettati sono: * " |
Spedizione
La spedizione del prodotto.
Campi | |
---|---|
price |
Prezzo di spedizione fisso, rappresentato come numero. |
country |
Il codice di territorio CLDR del paese in cui verrà spedito un articolo. |
region |
La regione geografica a cui si applica una tariffa di spedizione. Per ulteriori informazioni, consulta regione. |
service |
Una descrizione libera della classe del servizio o della velocità di consegna. |
location_ |
L'ID numerico di una località a cui si applica la tariffa di spedizione, come definito nell'API AdWords. |
location_ |
La località in cui è applicabile la spedizione, rappresentata da un nome gruppo di località. |
postal_ |
L'intervallo di codici postali a cui si applica la tariffa di spedizione, rappresentato da un codice postale, da un prefisso di codice postale seguito da un carattere jolly *, da un intervallo compreso tra due codici postali o da due prefissi di codice postale di uguale lunghezza. |
min_ |
Tempo di elaborazione minimo (incluso) tra la ricezione e la spedizione dell'ordine in giorni lavorativi. 0 indica che l'ordine viene spedito lo stesso giorno in cui viene ricevuto, se ciò avviene prima dell'orario limite. |
max_ |
Tempo di elaborazione massimo (incluso) tra la ricezione e la spedizione dell'ordine in giorni lavorativi. 0 indica che l'ordine viene spedito lo stesso giorno in cui viene ricevuto, se ciò avviene prima dell'orario limite. Sia |
min_ |
Tempo di transito minimo (incluso) tra la data di spedizione dell'ordine e la data di consegna in giorni lavorativi. 0 indica che l'ordine viene consegnato lo stesso giorno della spedizione. |
max_ |
Tempo di transito massimo (incluso) tra la data di spedizione dell'ordine e la data di consegna in giorni lavorativi. 0 indica che l'ordine viene consegnato lo stesso giorno della spedizione. Sia |
ShippingDimension
La dimensione ShippingDimension del prodotto.
Campi | |
---|---|
value |
La dimensione del prodotto utilizzata per calcolare il costo di spedizione dell'articolo. |
unit |
L'unità di valore. |
ShippingWeight
Il valore ShippingWeight del prodotto.
Campi | |
---|---|
value |
Il peso del prodotto utilizzato per calcolare il costo di spedizione dell'articolo. |
unit |
L'unità di valore. |
SubscriptionCost
Il valore SubscriptionCost del prodotto.
Campi | |
---|---|
period |
Il tipo di periodo di abbonamento. I valori supportati sono: * " |
period_ |
Il numero di periodi di validità dell'abbonamento che l'acquirente deve pagare. |
amount |
L'importo che l'acquirente deve pagare per ogni periodo di abbonamento. |
SubscriptionPeriod
Il periodo di abbonamento del prodotto.
Enum | |
---|---|
SUBSCRIPTION_PERIOD_UNSPECIFIED |
Indica che il periodo di abbonamento non è specificato. |
MONTH |
Indica che il periodo di abbonamento è mensile. |
YEAR |
Indica che il periodo di abbonamento è un anno. |
Imposta
L'IVA del prodotto.
Campi | |
---|---|
rate |
La percentuale dell'aliquota fiscale applicabile al prezzo dell'articolo. |
country |
Il paese in cui l'articolo è soggetto a tassazione, specificato come codice di territorio CLDR. |
region |
La regione geografica a cui si applica l'aliquota fiscale. |
tax_ |
Imposta su true se le imposte vengono addebitate sulla spedizione. |
location_ |
L'ID numerico di una località a cui si applica l'aliquota fiscale, come definito nell'API AdWords. |
postal_ |
L'intervallo di codici postali a cui si applica l'aliquota fiscale, rappresentato da un codice postale, da un prefisso di codice postale che utilizza il carattere jolly *, da un intervallo compreso tra due codici postali o da due prefissi di codice postale di uguale lunghezza. Esempi: 94114, 94*, 94002-95460, 94*-95*. |
UnitPricingBaseMeasure
La misura di base del prezzo unitario del prodotto.
Campi | |
---|---|
value |
Il denominatore del prezzo unitario. |
unit |
L'unità del denominatore. |
UnitPricingMeasure
La misura UnitPricingMeasure del prodotto.
Campi | |
---|---|
value |
La misura di un articolo. |
unit |
L'unità di misura. |