- Rappresentazione JSON
- Rata
- SubscriptionCost
- SubscriptionPeriod
- LoyaltyPoints
- LoyaltyProgram
- ProductDimension
- ProductWeight
- Spedizione
- FreeShippingThreshold
- ShippingWeight
- ShippingDimension
- Imposte
- UnitPricingMeasure
- UnitPricingBaseMeasure
- ProductDetail
- CloudExportAdditionalProperties
- Certificazione
- ProductStructuredTitle
- ProductStructuredDescription
Attributi.
Rappresentazione JSON |
---|
{ "additionalImageLinks": [ string ], "expirationDate": string, "disclosureDate": string, "availabilityDate": string, "gtin": [ string ], "price": { object ( |
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 le dimensioni di un articolo. |
unit |
La preferenza del denominatore del prezzo unitario. |
ads |
Simile ad adsGrouping, 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 di 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. |
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 il prodotto 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, utilizzata per configurare il collegamento fiscale dettagliato nelle impostazioni fiscali a livello di account. |
energy |
La classe energetica come definita nella direttiva UE 2010/30/UE. |
min |
La classe energetica come definita nella direttiva UE 2010/30/UE. |
max |
La classe energetica come definita nella 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 elementi 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'IA. |
structured |
Descrizione strutturata per le descrizioni generate con un algoritmo (IA). |
Rata
Un messaggio che rappresenta la rata.
Rappresentazione JSON |
---|
{ "months": string, "amount": { object ( |
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: * " |
SubscriptionCost
Il valore SubscriptionCost del prodotto.
Rappresentazione JSON |
---|
{ "period": enum ( |
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. |
LoyaltyPoints
Un messaggio che rappresenta i punti fedeltà.
Rappresentazione JSON |
---|
{ "name": string, "pointsValue": string, "ratio": number } |
Campi | |
---|---|
name |
Nome del programma fedeltà a punti. Si consiglia di limitare il nome a 12 caratteri standard o 24 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à.
Rappresentazione JSON |
---|
{ "programLabel": string, "tierLabel": string, "price": { object ( |
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 gli abbonati al 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 per un acquisto. |
member |
Un intervallo di date durante il quale l'articolo è idoneo per il prezzo per i soci. 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. |
ProductDimension
La dimensione del prodotto.
Rappresentazione JSON |
---|
{ "value": number, "unit": string } |
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: * " |
ProductWeight
Il peso del prodotto.
Rappresentazione JSON |
---|
{ "value": number, "unit": string } |
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.
Rappresentazione JSON |
---|
{
"price": {
object ( |
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 |
FreeShippingThreshold
Condizioni da soddisfare per poter usufruire della spedizione gratuita per un prodotto.
Rappresentazione JSON |
---|
{
"country": string,
"priceThreshold": {
object ( |
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. |
ShippingWeight
Il valore ShippingWeight del prodotto.
Rappresentazione JSON |
---|
{ "value": number, "unit": string } |
Campi | |
---|---|
value |
Il peso del prodotto utilizzato per calcolare il costo di spedizione dell'articolo. |
unit |
L'unità di valore. |
ShippingDimension
La dimensione ShippingDimension del prodotto.
Rappresentazione JSON |
---|
{ "value": number, "unit": string } |
Campi | |
---|---|
value |
La dimensione del prodotto utilizzata per calcolare il costo di spedizione dell'articolo. |
unit |
L'unità di valore. |
Imposta
L'IVA del prodotto.
Rappresentazione JSON |
---|
{ "rate": number, "country": string, "region": string, "taxShip": boolean, "locationId": string, "postalCode": string } |
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*. |
UnitPricingMeasure
La misura UnitPricingMeasure del prodotto.
Rappresentazione JSON |
---|
{ "value": number, "unit": string } |
Campi | |
---|---|
value |
La misura di un articolo. |
unit |
L'unità di misura. |
UnitPricingBaseMeasure
La misura di base del prezzo unitario del prodotto.
Rappresentazione JSON |
---|
{ "value": string, "unit": string } |
Campi | |
---|---|
value |
Il denominatore del prezzo unitario. |
unit |
L'unità del denominatore. |
ProductDetail
I dettagli del prodotto.
Rappresentazione JSON |
---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
Campi | |
---|---|
section |
L'intestazione della sezione utilizzata per raggruppare un insieme di dettagli del prodotto. |
attribute |
Il nome del dettaglio del prodotto. |
attribute |
Il valore del dettaglio del prodotto. |
CloudExportAdditionalProperties
Proprietà del prodotto per l'API Cloud Retail. Ad esempio, le proprietà per un prodotto TV potrebbero essere "Screen-Resolution" o "Screen-Size".
Rappresentazione JSON |
---|
{ "textValue": [ string ], "intValue": [ string ], "floatValue": [ number ], "propertyName": string, "boolValue": boolean, "minValue": number, "maxValue": number, "unitCode": string } |
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, per un prodotto TV 100,00. |
unit |
Unità della proprietà specificata. Ad esempio, "Pixel" per un prodotto TV. La dimensione massima della stringa è 256 B. |
Certificazione
Certificazione del prodotto, inizialmente introdotta per la conformità all'etichettatura energetica dell'UE utilizzando il database EPREL dell'UE.
Rappresentazione JSON |
---|
{ "certificationAuthority": string, "certificationName": string, "certificationCode": string, "certificationValue": string } |
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. |
ProductStructuredTitle
Titolo strutturato, per i titoli creati con l'IA.
Rappresentazione JSON |
---|
{ "digitalSourceType": string, "content": string } |
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 |
ProductStructuredDescription
Descrizione strutturata per le descrizioni generate con un algoritmo (IA).
Rappresentazione JSON |
---|
{ "digitalSourceType": string, "content": string } |
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 è 5000 caratteri |