REST Resource: accounts.products

Risorsa: prodotto

Il prodotto elaborato, creato a partire da più [input del prodotto][[google.shopping.content.bundles.Products.ProductInput] dopo l'applicazione di regole e origini dati supplementari. Questo prodotto elaborato corrisponde a quanto mostrato nel tuo account Merchant Center, negli annunci Shopping e in altre piattaforme Google. Ogni prodotto viene creato a partire da un solo input del prodotto dell'origine dati principale e da più input di origine dati supplementari. Dopo aver inserito, aggiornato o eliminato un input di prodotto, potrebbero essere necessari diversi minuti prima che sia possibile recuperare il prodotto elaborato aggiornato.

Tutti i campi del prodotto elaborato e i relativi messaggi secondari corrispondono al nome dell'attributo corrispondente nella specifica dei dati di prodotto, con alcune eccezioni.

Rappresentazione JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Campi
name

string

Il nome del prodotto. Formato: "{product.name=accounts/{account}/products/{product}}"
channel

enum (ChannelEnum)

Solo output. Il canale del prodotto.
offerId

string

Solo output. Il tuo identificatore univoco per il prodotto. Lo stesso vale per l'input del prodotto e il prodotto elaborato. Gli spazi vuoti iniziali e finali vengono rimossi e più spazi vuoti vengono sostituiti da un unico spazio vuoto al momento dell'invio. Consulta la specifica dei dati di prodotto per ulteriori dettagli.
contentLanguage

string

Solo output. Il codice lingua ISO 639-1 a due lettere del prodotto.
feedLabel

string

Solo output. L'etichetta del feed per il prodotto.
dataSource

string

Solo output. L'origine dati principale del prodotto.
attributes

object (Attributes)

Solo output. Un elenco di attributi del prodotto.
customAttributes[]

object (CustomAttribute)

Solo output. Un elenco di attributi personalizzati (forniti dal commerciante). Può essere utilizzato anche per inviare qualsiasi attributo della specifica dei dati in forma generica (ad esempio, { "name": "size type", "value": "regular" }). Ciò è utile per inviare attributi non esposti esplicitamente dall'API, come gli attributi aggiuntivi utilizzati per Acquista su Google.
productStatus

object (ProductStatus)

Solo output. Lo stato di un prodotto, i problemi di convalida dei dati, ovvero le informazioni su un prodotto calcolate in modo asincrono.
versionNumber

string (int64 format)

Solo output. Rappresenta la versione esistente (aggiornamento) del prodotto, che può essere utilizzata per preservare l'ordine corretto quando vengono eseguiti più aggiornamenti contemporaneamente.

Se impostato, l'inserimento viene impedito quando il numero di versione è inferiore a quello corrente del prodotto esistente. Il reinserimento (ad esempio, l'aggiornamento del prodotto dopo 30 giorni) può essere eseguito con l'attuale versionNumber.

Supportata solo per gli inserimenti nelle origini dati principali.

Se l'operazione viene impedita, verrà restituita l'eccezione interrotta.

Attributi

Attributi.

Rappresentazione JSON 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
Campi
expirationDate

string (Timestamp format)

La data di scadenza dell'articolo, come specificato al momento dell'inserimento, nel formato ISO 8601. La data di scadenza effettiva è esposta in productstatuses come googleExpirationDate e potrebbe essere precedente se expirationDate è troppo lontana nel futuro.
disclosureDate

string (Timestamp format)

La data e l'ora in cui un'offerta diventa visibile nei risultati di ricerca sulle piattaforme YouTube di Google, in formato ISO 8601. Per saperne di più, consulta la [Data di divulgazione]( https://support.google.com/merchants/answer/13034208).
availabilityDate

string (Timestamp format)

Il giorno in cui un prodotto prenotato diventa disponibile per la consegna, in formato ISO 8601.
price

object (Price)

Prezzo dell'articolo.
installment

object (Installment)

Numero e importo delle rate da pagare per un articolo.
subscriptionCost

object (SubscriptionCost)

Numero di periodi (mesi o anni) e importo del pagamento per periodo per un articolo con un contratto di abbonamento associato.
loyaltyPoints

object (LoyaltyPoints)

Punti fedeltà che gli utenti ricevono dopo aver acquistato l'articolo. Japan.
loyaltyPrograms[]

object (LoyaltyProgram)

Un elenco di informazioni sul programma fedeltà utilizzate per mostrare all'utente di questo elemento i vantaggi del programma fedeltà (ad es. prezzi migliori, punti e così via).
productTypes[]

string

Categorie dell'articolo (formattate come nella specifica dei dati di prodotto).
salePrice

object (Price)

Prezzo scontato pubblicizzato dell'articolo.
salePriceEffectiveDate

object (Interval)

Intervallo di date durante il quale l'articolo è in saldo (consulta la specifica dei dati di prodotto).
productHeight

object (ProductDimension)

L'altezza del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 3000 (incluso).
productLength

object (ProductDimension)

La lunghezza del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 3000 (incluso).
productWidth

object (ProductDimension)

La larghezza del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 3000 (incluso).
productWeight

object (ProductWeight)

Il peso del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 2000 (incluso).
shipping[]

object (Shipping)

Regole di spedizione.
freeShippingThreshold[]

object (FreeShippingThreshold)

Condizioni che devono essere soddisfatte per poter usufruire della spedizione gratuita di un prodotto.
shippingWeight

object (ShippingWeight)

Peso dell'articolo per la spedizione.
shippingLength

object (ShippingDimension)

Lunghezza dell'articolo per la spedizione.
shippingWidth

object (ShippingDimension)

Larghezza dell'articolo per la spedizione.
shippingHeight

object (ShippingDimension)

Altezza dell'articolo per la spedizione.
sizeTypes[]

string

Il taglio dell'articolo. Può essere utilizzato per rappresentare i tipi di taglie combinati per gli articoli di abbigliamento. È possibile fornire al massimo due tipi di taglia (consulta la sezione [https://support.google.com/merchants/answer/6324497](tipo di taglia)).
taxes[]

object (Tax)

Dati fiscali.
unitPricingMeasure

object (UnitPricingMeasure)

La misura e la dimensione di un articolo.
unitPricingBaseMeasure

object (UnitPricingBaseMeasure)

La preferenza del denominatore del prezzo unitario.
adsLabels[]

string

Simile ad adsGrouping, ma funziona solo su CPC.
costOfGoodsSold

object (Price)

Costo del venduto. Utilizzato per la generazione di report sul profitto lordo.
productDetails[]

object (ProductDetail)

Specifiche tecniche o dettagli aggiuntivi del prodotto.
productHighlights[]

string

Elenchi puntati che descrivono le caratteristiche principali di un prodotto.
displayAdsSimilarIds[]

string

Suggerimenti specificati dall'inserzionista.
promotionIds[]

string

L'ID univoco di una promozione.
includedDestinations[]

string

L'elenco di 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 excludedDestinations.
excludedDestinations[]

string

L'elenco di destinazioni da escludere per questo target (corrisponde alle caselle di controllo deselezionate in Merchant Center).
shoppingAdsExcludedCountries[]

string

Elenco di codici paese (ISO 3166-1 alpha-2) per escludere l'offerta dalla destinazione degli annunci Shopping. I paesi di questo elenco sono stati rimossi da quelli configurati nelle impostazioni dell'origine dati.
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

Campi aggiuntivi da esportare nel programma Cloud Retail.
certifications[]

object (Certification)

Certificazioni di prodotto, ad esempio per l'etichettatura dell'efficienza energetica dei prodotti registrati nel database EU EPREL. Per saperne di più, consulta l'articolo del Centro assistenza.
autoPricingMinPrice

object (Price)

Una salvaguardia nei progetti "Sconti automatici" (https://support.google.com/merchants/answer/10295759) e "Promozioni dinamiche" (https://support.google.com/merchants/answer/13949249) per garantire che gli sconti sulle offerte dei commercianti non scendano al di sotto di questo valore, preservando così il valore e la redditività dell'offerta.
identifierExists

boolean

Imposta questo valore su false quando l'articolo non dispone di codici identificativi di prodotto appropriati alla sua categoria, come GTIN, MPN e marca. Il valore predefinito è true, se non viene fornito.
isBundle

boolean

Se l'articolo è un set definito dal commerciante. Un set è un raggruppamento personalizzato di prodotti diversi venduti da un commerciante a un unico prezzo.
title

string

Titolo dell'articolo.
description

string

Descrizione dell'articolo.
adult

boolean

Impostalo su true se l'articolo è rivolto agli adulti.
ageGroup

string

Scegli come target l'età dell'articolo.
availability

string

Stato di disponibilità dell'articolo.
brand

string

Brand dell'articolo.
color

string

Colore dell'articolo.
condition

string

Condizione o stato dell'articolo.
gender

string

Genere target dell'articolo.
googleProductCategory

string

La categoria dell'articolo di Google (consulta la tassonomia dei prodotti di Google). Quando esegui query sui prodotti, questo campo conterrà il valore fornito dall'utente. Al momento non è possibile recuperare le categorie prodotto Google assegnate automaticamente tramite l'API.
gtin

string

GTIN (Global Trade Item Number) dell'articolo.
itemGroupId

string

Identificatore condiviso per tutte le varianti dello stesso prodotto.
material

string

Il materiale con cui è realizzato l'articolo.
mpn

string

MPN (Manufacturer Part Number) dell'articolo.
pattern

string

Il motivo dell'articolo (ad esempio, a pois).
sellOnGoogleQuantity

string (int64 format)

La quantità del prodotto che è disponibile per la vendita su Google. Supportata solo per i prodotti online.
maxHandlingTime

string (int64 format)

Tempo di elaborazione massimo del prodotto (in giorni lavorativi).
minHandlingTime

string (int64 format)

Tempo di elaborazione minimo del prodotto (in giorni lavorativi).
shippingLabel

string

L'etichetta spedizione del prodotto, utilizzata per raggruppare il prodotto nelle regole di spedizione a livello di account.
transitTimeLabel

string

L'etichetta del tempo di transito del prodotto, utilizzata per raggruppare il prodotto in tabelle del tempo di transito a livello di account.
size

string

Taglia dell'articolo. È consentito un solo valore. Per le varianti con taglie diverse, inserisci un prodotto separato per ogni taglia con lo stesso valore itemGroupId (consulta la [https://support.google.com/merchants/answer/6324492](definizione della taglia)).
sizeSystem

string

Sistema in cui vengono specificate le dimensioni. Consigliato per gli articoli di abbigliamento.
taxCategory

string

La categoria fiscale del prodotto, utilizzata per configurare la presenza fiscale dettagliata nelle impostazioni fiscali a livello di account.
energyEfficiencyClass

string

La classe energetica definita nella direttiva UE 2010/30/UE.
minEnergyEfficiencyClass

string

La classe energetica definita nella direttiva UE 2010/30/UE.
maxEnergyEfficiencyClass

string

La classe energetica definita nella direttiva UE 2010/30/UE.
multipack

string (int64 format)

Il numero di prodotti identici in un multipack definito dal commerciante.
adsGrouping

string

Utilizzato per raggruppare gli elementi in modo arbitrario. Solo per % CPA, sconsigliato altrimenti.
adsRedirect

string

Consente agli inserzionisti di ignorare l'URL dell'articolo quando il prodotto viene mostrato nel contesto degli annunci di prodotto.
displayAdsId

string

Identificatore di un articolo per le campagne di remarketing dinamico.
displayAdsTitle

string

Titolo di un elemento per le campagne di remarketing dinamico.
displayAdsValue

number

Margine di offerta per le campagne di remarketing dinamico.
pickupMethod

string

L'opzione di ritiro dell'articolo.
pickupSla

string

Tempistiche del ritiro dell'articolo in negozio.
customLabel0

string

Etichetta personalizzata 0 per il raggruppamento personalizzato degli articoli in una campagna Shopping.
customLabel1

string

Etichetta personalizzata 1 per il raggruppamento personalizzato degli articoli in una campagna Shopping.
customLabel2

string

Etichetta personalizzata 2 per il raggruppamento personalizzato degli articoli in una campagna Shopping.
customLabel3

string

Etichetta personalizzata 3 per il raggruppamento personalizzato degli articoli in una campagna Shopping.
customLabel4

string

Etichetta personalizzata 4 per il raggruppamento personalizzato degli articoli in una campagna Shopping.
externalSellerId

string

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

string

La pubblicazione di questo elemento sarà temporaneamente in pausa.
structuredTitle

object (ProductStructuredTitle)

Titolo strutturato per titoli generati tramite algoritmi (IA).
structuredDescription

object (ProductStructuredDescription)

Descrizione strutturata per descrizioni generate tramite algoritmi (IA).

Rata

Un messaggio che rappresenta la rata.

Rappresentazione JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
Campi
months

string (int64 format)

Il numero di rate che l'acquirente deve pagare.
amount

object (Price)

L'importo che l'acquirente deve pagare ogni mese.
downpayment

object (Price)

L'importo del pagamento iniziale che l'acquirente deve pagare.
creditType

string

Tipo di pagamenti rateali. I valori supportati sono: * "finance" * "lease"

SubscriptionCost

Il costo dell'abbonamento del prodotto.

Rappresentazione JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Campi
period

enum (SubscriptionPeriod)

Il tipo di periodo di abbonamento. I valori supportati sono: * "month" * "year"
periodLength

string (int64 format)

Il numero di periodi di abbonamento che l'acquirente deve pagare.
amount

object (Price)

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 è mese.
YEAR Indica che il periodo di abbonamento è anno.

LoyaltyPoints

Un messaggio che rappresenta i punti fedeltà.

Rappresentazione JSON 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
Campi
name

string

Nome del programma a punti fedeltà. Ti consigliamo di limitare il nome a 12 caratteri a larghezza intera o 24 caratteri romani.
pointsValue

string (int64 format)

I punti fedeltà del rivenditore in valore assoluto.
ratio

number

Il rapporto di un punto se convertito in valuta. Google deduce 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 un programma fedeltà.

Rappresentazione JSON 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
Campi
programLabel

string

L'etichetta del programma fedeltà. Si tratta di un'etichetta interna che identifica in modo univoco la relazione tra una persona giuridica commerciante e un'entità programma fedeltà. L'etichetta deve essere fornita in modo che il sistema possa associare le risorse riportate di seguito (ad esempio prezzo e punti) a un commerciante. Il programma corrispondente deve essere collegato all'account commerciante.
tierLabel

string

L'etichetta del livello all'interno del programma fedeltà. Deve corrispondere a una delle etichette all'interno del programma.
price

object (Price)

Il prezzo per gli abbonati di un determinato livello, ovvero il prezzo scontato istantaneo. Deve essere inferiore o uguale al prezzo normale.
cashbackForFutureUse

object (Price)

Il rimborso in contanti che può essere utilizzato per acquisti futuri.
loyaltyPoints

string (int64 format)

L'importo dei punti fedeltà guadagnati per un acquisto.

ProductDimension

La dimensione del prodotto.

Rappresentazione JSON 
{
  "value": number,
  "unit": string
}
Campi
value

number

Obbligatoria. Il valore della dimensione rappresentato come un numero. Il valore può avere una precisione massima di quattro cifre decimali.
unit

string

Obbligatoria. Le unità di dimensione. I valori accettati sono: * "in" * "cm"

ProductWeight

Il peso del prodotto.

Rappresentazione JSON 
{
  "value": number,
  "unit": string
}
Campi
value

number

Obbligatoria. La ponderazione rappresentata come un numero. La ponderazione può avere una precisione massima di quattro cifre decimali.
unit

string

Obbligatoria. L'unità di peso. I valori accettati sono: * "g" * "kg" * "oz" * "lb"

Spedizione

La spedizione del prodotto.

Rappresentazione JSON 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
Campi
price

object (Price)

Prezzo di spedizione fisso, rappresentato da un numero.
country

string

Il codice di territorio CLDR del paese in cui verrà spedito un articolo.
region

string

L'area geografica a cui si applica una tariffa di spedizione. Per ulteriori informazioni, visita la pagina relativa alla regione.
service

string

Una descrizione in formato libero della classe del servizio o della velocità di consegna.
locationId

string (int64 format)

L'ID numerico di una località a cui si applica la tariffa di spedizione, come definito nell'API di AdWords.
locationGroupName

string

La località in cui è applicabile la spedizione, rappresentata dal nome di un gruppo di località.
postalCode

string

L'intervallo di codici postali a cui si applica la tariffa di spedizione, rappresentato da un codice postale, un prefisso di codice postale seguito da un carattere jolly *, un intervallo compreso tra due codici postali o due prefissi di codici postali di uguale lunghezza.
minHandlingTime

string (int64 format)

Tempo di elaborazione minimo (incluso) tra la ricezione dell'ordine e la spedizione in giorni lavorativi. 0 significa che l'ordine viene spedito lo stesso giorno in cui viene ricevuto se avviene prima dell'orario limite. [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] può essere presente solo insieme a [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time], ma non è obbligatorio se è presente [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].
maxHandlingTime

string (int64 format)

Tempo di elaborazione massimo (incluso) tra la ricezione dell'ordine e la spedizione in giorni lavorativi. 0 significa che l'ordine viene spedito lo stesso giorno in cui viene ricevuto se avviene prima dell'orario limite. Se fornisci le velocità di spedizione, sono obbligatori sia [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] sia [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. [minhandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] è facoltativo se è presente [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time].
minTransitTime

string (int64 format)

Tempo di transito minimo (incluso) tra la data di spedizione dell'ordine e la data in cui viene consegnato in giorni lavorativi. 0 significa che l'ordine viene consegnato lo stesso giorno della spedizione. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] può essere presente solo insieme a [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time], ma non è obbligatorio se è presente [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time].
maxTransitTime

string (int64 format)

Tempo di transito massimo (incluso) tra la data di spedizione dell'ordine e la data in cui viene consegnato in giorni lavorativi. 0 significa che l'ordine viene consegnato lo stesso giorno della spedizione. Se fornisci le velocità di spedizione, sono obbligatori sia [maxhandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] sia [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] è facoltativo se è presente [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time].

FreeShippingThreshold

Condizioni che devono essere soddisfatte per poter usufruire della spedizione gratuita di un prodotto.

Rappresentazione JSON 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
Campi
country

string

Il codice di territorio CLDR del paese in cui verrà spedito un articolo.
priceThreshold

object (Price)

Il prezzo minimo del prodotto affinché il costo di spedizione diventi senza costi. Rappresentata come un numero.

ShippingWeight

Il peso del pacco del prodotto.

Rappresentazione JSON 
{
  "value": number,
  "unit": string
}
Campi
value

number

Il peso del prodotto utilizzato per calcolare il costo di spedizione dell'articolo.
unit

string

L'unità di valore.

ShippingDimension

La dimensione di spedizione del prodotto.

Rappresentazione JSON 
{
  "value": number,
  "unit": string
}
Campi
value

number

La dimensione del prodotto utilizzata per calcolare il costo di spedizione dell'articolo.
unit

string

L'unità di valore.

Tasse

La tassa sul prodotto.

Rappresentazione JSON 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
Campi
rate

number

La percentuale dell'aliquota fiscale applicabile al prezzo dell'articolo.
country

string

Il paese in cui l'articolo è tassato, specificato come codice di territorio CLDR.
region

string

L'area geografica a cui si applica l'aliquota fiscale.
taxShip

boolean

Imposta il valore su true se viene addebitata l'imposta sulla spedizione.
locationId

string (int64 format)

L'ID numerico di una località a cui si applica l'aliquota fiscale, come definito nell'API di AdWords.
postalCode

string

L'intervallo di codici postali a cui si applica l'aliquota fiscale, rappresentato da un codice postale, un prefisso di codice postale che utilizza il carattere jolly *, un intervallo compreso tra due codici postali o due prefissi di codici postali di uguale lunghezza. Esempi: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingMeasure

L'unità di misura del prezzo unitaria del prodotto.

Rappresentazione JSON 
{
  "value": number,
  "unit": string
}
Campi
value

number

La misura di un elemento.
unit

string

L'unità di misura.

UnitPricingBaseMeasure

Il valore UnitPricingBaseMisura del prodotto.

Rappresentazione JSON 
{
  "value": string,
  "unit": string
}
Campi
value

string (int64 format)

Il denominatore del prezzo unitario.
unit

string

L'unità del denominatore.

ProductDetail

I dettagli del prodotto.

Rappresentazione JSON 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Campi
sectionName

string

L'intestazione della sezione utilizzata per raggruppare un insieme di dettagli del prodotto.
attributeName

string

Il nome del dettaglio del prodotto.
attributeValue

string

Il valore del dettaglio del prodotto.

CloudExportAdditionalProperties

Proprietà del prodotto per l'API Cloud Retail. Ad esempio, le proprietà di un prodotto TV potrebbero essere "Risoluzione schermo" o "Dimensioni schermo".

Rappresentazione JSON 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
Campi
textValue[]

string

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 è 256 caratteri.
intValue[]

string (int64 format)

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.
floatValue[]

number

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.
propertyName

string

Nome della proprietà specificata. Ad esempio, "Risoluzione dello schermo" per un prodotto TV. La dimensione massima della stringa è 256 caratteri.
boolValue

boolean

Valore booleano della proprietà specificata. Ad esempio, per un prodotto TV, "Vero" o "Falso" se lo schermo è UHD.
minValue

number

Valore in virgola mobile minimo della proprietà specificata. Ad esempio, per un prodotto TV 1.00.
maxValue

number

Valore in virgola mobile massimo della proprietà specificata. Ad esempio, per un prodotto TV 100,00.
unitCode

string

Unità della proprietà specificata. Ad esempio, "Pixel" per un prodotto TV. La dimensione massima della stringa è 256 byte.

Certificazione

Certificazione di prodotto, introdotta inizialmente per la conformità all'etichettatura dell'efficienza energetica nell'UE utilizzando il database EPREL dell'UE.

Rappresentazione JSON 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
Campi
certificationAuthority

string

L'autorità di certificazione, ad esempio "Commissione_europea". La lunghezza massima è di 2000 caratteri.
certificationName

string

Il nome della certificazione, ad esempio "EPREL". La lunghezza massima è di 2000 caratteri.
certificationCode

string

Il codice di certificazione. La lunghezza massima è di 2000 caratteri.
certificationValue

string

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 titoli generati tramite algoritmi (IA).

Rappresentazione JSON 
{
  "digitalSourceType": string,
  "content": string
}
Campi
digitalSourceType

string

Il tipo di origine digitale, ad esempio "training_algorithmic_media". A seguito di IPTC. La lunghezza massima è di 40 caratteri.
content

string

La lunghezza massima del testo del titolo è 150 caratteri

ProductStructuredDescription

Descrizione strutturata per descrizioni generate tramite algoritmi (IA).

Rappresentazione JSON 
{
  "digitalSourceType": string,
  "content": string
}
Campi
digitalSourceType

string

Il tipo di origine digitale, ad esempio "training_algorithmic_media". A seguito di IPTC. La lunghezza massima è di 40 caratteri.
content

string

La lunghezza massima del testo della descrizione è di 5000 caratteri

ProductStatus

Lo stato di un prodotto, i problemi di convalida dei dati, ovvero le informazioni su un prodotto calcolate in modo asincrono.

Rappresentazione JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Campi
destinationStatuses[]

object (DestinationStatus)

Le destinazioni previste per il prodotto.
itemLevelIssues[]

object (ItemLevelIssue)

Un elenco di tutti i problemi associati al prodotto.
creationDate

string (Timestamp format)

Data in cui è stato creato l'elemento, in formato ISO 8601.
lastUpdateDate

string (Timestamp format)

Data dell'ultimo aggiornamento dell'articolo, in formato ISO 8601.
googleExpirationDate

string (Timestamp format)

Data di scadenza dell'articolo, in formato ISO 8601.

DestinationStatus

Lo stato della destinazione dello stato dei prodotti.

Rappresentazione JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Campi
reportingContext

enum (ReportingContextEnum)

Il nome del contesto del report.
approvedCountries[]

string

Elenco dei codici paese (ISO 3166-1 alpha-2) in cui l'offerta è approvata.
pendingCountries[]

string

Elenco di codici paese (ISO 3166-1 alpha-2) in cui l'offerta è in attesa di approvazione.
disapprovedCountries[]

string

Elenco dei codici paese (ISO 3166-1 alpha-2) in cui l'offerta non è approvata.

ItemLevelIssue

Il valore ItemLevelIssue dello stato del prodotto.

Rappresentazione JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Campi
code

string

Il codice di errore del problema.
severity

enum (Severity)

In che modo questo problema influisce sulla pubblicazione dell'offerta.
resolution

string

Se il problema può essere risolto dal commerciante.
attribute

string

Il nome dell'attributo, se il problema è causato da un singolo attributo.
reportingContext

enum (ReportingContextEnum)

Il contesto dei report a cui si applica il problema.
description

string

Una breve descrizione del problema in inglese.
detail

string

Una descrizione dettagliata del problema in inglese.
documentation

string

L'URL di una pagina web per facilitare la risoluzione del problema.
applicableCountries[]

string

Elenco dei codici paese (ISO 3166-1 alpha-2) in cui il problema si applica all'offerta.

Gravità

Il modo in cui il problema influisce sulla pubblicazione del prodotto.

Enum
SEVERITY_UNSPECIFIED Non specificato.
NOT_IMPACTED Questo problema rappresenta un avviso e non ha un effetto diretto sul prodotto.
DEMOTED Il prodotto è stato retrocesso e molto probabilmente ha un rendimento limitato nei risultati di ricerca
DISAPPROVED Il problema non approva il prodotto.

Metodi

get

 Recupera il prodotto elaborato dal tuo account Merchant Center.

list

 Elenca i prodotti elaborati nel tuo account Merchant Center.