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)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 funziona solo per i prodotti con canale online.
| DeleteProductInput |
|---|
|
Elimina l'input di un prodotto dall'account Merchant Center. Dopo aver inserito, aggiornato o eliminato un input di prodotto, potrebbero essere necessari diversi minuti prima che sia possibile recuperare il prodotto elaborato.
|
| InsertProductInput |
|---|
|
Carica un input di prodotto nel tuo account Merchant Center. Se esiste già un input con gli stessi valori contentLanguage, offerId e dataSource, questo metodo sostituisce questa voce. Dopo aver inserito, aggiornato o eliminato un input di prodotto, potrebbero essere necessari diversi minuti prima che sia possibile recuperare il prodotto elaborato.
|
ProductsService
Servizio per utilizzare la risorsa Product. Questo servizio funziona 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 di prodotto, potrebbero essere necessari diversi minuti prima che sia possibile recuperare il prodotto finale aggiornato.
|
| ListProducts |
|---|
|
Elenca i prodotti elaborati nel tuo account Merchant Center. La risposta potrebbe contenere meno elementi di quelli specificati da pageSize. Affidati a pageToken per determinare se ci sono altri elementi da richiedere. Dopo aver inserito, aggiornato o eliminato un input di prodotto, potrebbero essere necessari diversi minuti prima che sia possibile recuperare il prodotto elaborato aggiornato.
|
Attributi
Attributi.
| Campi | |
|---|---|
additional_image_links[] |
URL aggiuntivi delle immagini dell'articolo. |
expiration_date |
La data di scadenza dell'articolo, come specificato al momento dell'inserimento, nel formato ISO 8601. La data di scadenza effettiva è esposta in |
disclosure_date |
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). |
availability_date |
Il giorno in cui un prodotto prenotato diventa disponibile per la consegna, in formato ISO 8601. |
price |
Prezzo dell'articolo. |
installment |
Numero e importo delle rate da pagare per un articolo. |
subscription_cost |
Numero di periodi (mesi o anni) e importo del pagamento per periodo per un articolo con un contratto di abbonamento associato. |
loyalty_points |
Punti fedeltà che gli utenti ricevono dopo aver acquistato l'articolo. Japan. |
loyalty_programs[] |
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). |
product_types[] |
Categorie dell'articolo (formattate come nella specifica dei dati di prodotto). |
sale_price |
Prezzo scontato pubblicizzato dell'articolo. |
sale_price_effective_date |
Intervallo di date durante il quale l'articolo è in saldo (consulta la specifica dei dati di prodotto). |
product_height |
L'altezza del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 3000 (incluso). |
product_length |
La lunghezza del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 3000 (incluso). |
product_width |
La larghezza del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 3000 (incluso). |
product_weight |
Il peso del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 2000 (incluso). |
shipping[] |
Regole di spedizione. |
free_shipping_threshold[] |
Condizioni che devono essere soddisfatte per poter usufruire della spedizione gratuita di un prodotto. |
shipping_weight |
Peso dell'articolo per la spedizione. |
shipping_length |
Lunghezza dell'articolo per la spedizione. |
shipping_width |
Larghezza dell'articolo per la spedizione. |
shipping_height |
Altezza dell'articolo per la spedizione. |
size_types[] |
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[] |
Dati fiscali. |
unit_pricing_measure |
La misura e la dimensione di un articolo. |
unit_pricing_base_measure |
La preferenza del denominatore del prezzo unitario. |
ads_labels[] |
Simile ad ads_grouping, ma funziona solo su CPC. |
cost_of_goods_sold |
Costo del venduto. Utilizzato per la generazione di report sul profitto lordo. |
product_details[] |
Specifiche tecniche o dettagli aggiuntivi del prodotto. |
product_highlights[] |
Elenchi puntati che descrivono le caratteristiche principali di un prodotto. |
display_ads_similar_ids[] |
Suggerimenti specificati dall'inserzionista. |
promotion_ids[] |
L'ID univoco di una promozione. |
included_destinations[] |
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 |
excluded_destinations[] |
L'elenco di destinazioni da escludere per questo target (corrisponde alle caselle di controllo deselezionate in Merchant Center). |
shopping_ads_excluded_countries[] |
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. |
lifestyle_image_links[] |
URL aggiuntivi di immagini a tema lifestyle dell'articolo, utilizzati per identificare esplicitamente le immagini che mostrano l'articolo in un contesto reale. Per ulteriori informazioni, leggi l'articolo del Centro assistenza. |
cloud_export_additional_properties[] |
Campi aggiuntivi da esportare nel programma Cloud Retail. |
certifications[] |
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. |
auto_pricing_min_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. |
identifier_exists |
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. |
is_bundle |
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 |
Titolo dell'articolo. |
description |
Descrizione dell'articolo. |
link |
URL che rimanda direttamente alla pagina dell'articolo sul tuo negozio online. |
mobile_link |
URL della versione della pagina di destinazione dell'articolo ottimizzata per il mobile. |
canonical_link |
URL della versione canonica della pagina di destinazione del tuo articolo. |
image_link |
URL di un'immagine dell'articolo. |
adult |
Impostalo su true se l'articolo è rivolto agli adulti. |
age_group |
Scegli come target l'età dell'articolo. |
availability |
Stato di disponibilità dell'articolo. |
brand |
Brand dell'articolo. |
color |
Colore dell'articolo. |
condition |
Condizione o stato dell'articolo. |
gender |
Genere target dell'articolo. |
google_product_category |
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 |
GTIN (Global Trade Item Number) dell'articolo. |
item_group_id |
Identificatore condiviso per tutte le varianti dello stesso prodotto. |
material |
Il materiale con cui è realizzato l'articolo. |
mpn |
MPN (Manufacturer Part Number) dell'articolo. |
pattern |
Il motivo dell'articolo (ad esempio, a pois). |
sell_on_google_quantity |
La quantità del prodotto che è disponibile per la vendita su Google. Supportata solo per i prodotti online. |
max_handling_time |
Tempo di elaborazione massimo del prodotto (in giorni lavorativi). |
min_handling_time |
Tempo di elaborazione minimo del prodotto (in giorni lavorativi). |
shipping_label |
L'etichetta spedizione del prodotto, utilizzata per raggruppare il prodotto nelle regole di spedizione a livello di account. |
transit_time_label |
L'etichetta del tempo di transito del prodotto, utilizzata per raggruppare il prodotto in tabelle del tempo 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_system |
Sistema in cui vengono specificate le dimensioni. Consigliato per gli articoli di abbigliamento. |
tax_category |
La categoria fiscale del prodotto, utilizzata per configurare la presenza fiscale dettagliata nelle impostazioni fiscali a livello di account. |
energy_efficiency_class |
La classe energetica definita nella direttiva UE 2010/30/UE. |
min_energy_efficiency_class |
La classe energetica definita nella direttiva UE 2010/30/UE. |
max_energy_efficiency_class |
La classe energetica definita nella direttiva UE 2010/30/UE. |
multipack |
Il numero di prodotti identici in un multipack definito dal commerciante. |
ads_grouping |
Utilizzato per raggruppare gli elementi in modo arbitrario. Solo per % CPA, sconsigliato altrimenti. |
ads_redirect |
Consente agli inserzionisti di ignorare l'URL dell'articolo quando il prodotto viene mostrato nel contesto degli annunci di prodotto. |
display_ads_id |
Identificatore di un articolo per le campagne di remarketing dinamico. |
display_ads_title |
Titolo di un elemento per le campagne di remarketing dinamico. |
display_ads_link |
URL direttamente alla pagina di destinazione dell'articolo per le campagne di remarketing dinamico. |
display_ads_value |
Margine di offerta per le campagne di remarketing dinamico. |
pickup_method |
L'opzione di ritiro dell'articolo. |
pickup_sla |
Tempistiche del ritiro dell'articolo in negozio. |
link_template |
Modello di link per la vetrina locale ospitata dal commerciante. |
mobile_link_template |
Modello di link per la vetrina locale ospitata dal commerciante ottimizzata per i dispositivi mobili. |
custom_label_0 |
Etichetta personalizzata 0 per il raggruppamento personalizzato degli articoli in una campagna Shopping. |
custom_label_1 |
Etichetta personalizzata 1 per il raggruppamento personalizzato degli articoli in una campagna Shopping. |
custom_label_2 |
Etichetta personalizzata 2 per il raggruppamento personalizzato degli articoli in una campagna Shopping. |
custom_label_3 |
Etichetta personalizzata 3 per il raggruppamento personalizzato degli articoli in una campagna Shopping. |
custom_label_4 |
Etichetta personalizzata 4 per il raggruppamento personalizzato degli articoli in una campagna Shopping. |
external_seller_id |
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 elemento sarà temporaneamente in pausa. |
virtual_model_link |
URL dell'immagine 3D dell'articolo. Per ulteriori informazioni, leggi l'articolo del Centro assistenza. |
structured_title |
Titolo strutturato per titoli generati tramite algoritmi (IA). |
structured_description |
Descrizione strutturata per descrizioni generate tramite algoritmi (IA). |
Certificazione
Certificazione di prodotto, introdotta inizialmente per la conformità all'etichettatura dell'efficienza energetica nell'UE utilizzando il database EPREL dell'UE.
| Campi | |
|---|---|
certification_authority |
L'autorità di certificazione, ad esempio "Commissione_europea". La lunghezza massima è di 2000 caratteri. |
certification_name |
Il nome della certificazione, ad esempio "EPREL". La lunghezza massima è di 2000 caratteri. |
certification_code |
Il codice di certificazione. La lunghezza massima è di 2000 caratteri. |
certification_value |
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à di un prodotto TV potrebbero essere "Risoluzione schermo" o "Dimensioni schermo".
| Campi | |
|---|---|
text_value[] |
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. |
int_value[] |
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_value[] |
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_name |
Nome della proprietà specificata. Ad esempio, "Risoluzione dello schermo" per un prodotto TV. La dimensione massima della stringa è 256 caratteri. |
bool_value |
Valore booleano della proprietà specificata. Ad esempio, per un prodotto TV, "Vero" o "Falso" se lo schermo è UHD. |
min_value |
Valore in virgola mobile minimo della proprietà specificata. Ad esempio, per un prodotto TV 1.00. |
max_value |
Valore in virgola mobile massimo della proprietà specificata. Ad esempio, per un prodotto TV 100,00. |
unit_code |
Unità della proprietà specificata. Ad esempio, "Pixel" per un prodotto TV. La dimensione massima della stringa è 256 byte. |
DeleteProductInputRequest
Messaggio di richiesta per il metodo DeleteProductInput.
| Campi | |
|---|---|
name |
Obbligatoria. Il nome della risorsa di input del prodotto da eliminare. Formato: accounts/{account}/productInputs/{product} |
data_source |
Obbligatoria. L'origine dati principale o supplementare da cui deve essere eliminato l'input del prodotto. Formato: |
FreeShippingThreshold
Condizioni che devono essere soddisfatte per poter usufruire della spedizione gratuita di un prodotto.
| Campi | |
|---|---|
country |
Il codice di territorio CLDR del paese in cui verrà spedito un articolo. |
price_threshold |
Il prezzo minimo del prodotto affinché il costo di spedizione diventi senza costi. Rappresentata come un numero. |
GetProductRequest
Messaggio di richiesta per il metodo GetProduct.
| Campi | |
|---|---|
name |
Obbligatoria. Il nome del prodotto da recuperare. Formato: |
InsertProductInputRequest
Messaggio di richiesta per il metodo InsertProductInput.
| Campi | |
|---|---|
parent |
Obbligatoria. L'account in cui verrà inserito il prodotto. Formato: accounts/{account} |
product_input |
Obbligatoria. L'input del prodotto da inserire. |
data_source |
Obbligatoria. 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. 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 del pagamento iniziale che l'acquirente deve pagare. |
credit_type |
Tipo di pagamenti rateali. I valori supportati sono: * " |
ListProductsRequest
Messaggio di richiesta per il metodo ListProducts.
| Campi | |
|---|---|
parent |
Obbligatoria. L'account per il quale elencare i prodotti elaborati. Formato: accounts/{account} |
page_size |
Il numero massimo di prodotti da restituire. Il servizio potrebbe restituire un valore inferiore a questo valore. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. Se non specificato, verrà restituito il numero massimo di prodotti. |
page_token |
Un token di pagina, ricevuto da una precedente chiamata a Durante l'impaginazione, tutti gli altri parametri forniti a |
ListProductsResponse
Messaggio di risposta per il metodo ListProducts.
| Campi | |
|---|---|
products[] |
I prodotti elaborati dall'account specificato. Questi sono i prodotti elaborati dopo l'applicazione delle regole e delle origini dati supplementari. |
next_page_token |
Un token, che può essere inviato come |
LoyaltyPoints
Un messaggio che rappresenta i punti fedeltà.
| Campi | |
|---|---|
name |
Nome del programma a punti fedeltà. Ti consigliamo di limitare il nome a 12 caratteri a larghezza intera o 24 caratteri romani. |
points_value |
I punti fedeltà del rivenditore in valore assoluto. |
ratio |
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à.
| Campi | |
|---|---|
program_label |
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. |
tier_label |
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 di un determinato livello, ovvero il prezzo scontato istantaneo. Deve essere inferiore o uguale al prezzo normale. |
cashback_for_future_use |
Il rimborso in contanti che può essere utilizzato per acquisti futuri. |
loyalty_points |
L'importo dei punti fedeltà guadagnati per un acquisto. |
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.
| Campi | |
|---|---|
name |
Il nome del prodotto. Formato: |
channel |
Solo output. Il canale del prodotto. |
offer_id |
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. |
content_language |
Solo output. Il codice lingua ISO 639-1 a due lettere del prodotto. |
feed_label |
Solo output. L'etichetta del feed per il prodotto. |
data_source |
Solo output. L'origine dati principale del prodotto. |
attributes |
Solo output. Un elenco di attributi del prodotto. |
custom_attributes[] |
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, |
product_status |
Solo output. Lo stato di un prodotto, i problemi di convalida dei dati, ovvero le informazioni su un prodotto calcolate in modo asincrono. |
version_number |
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 Supportata solo per gli inserimenti nelle origini dati principali. Se l'operazione viene impedita, verrà restituita l'eccezione interrotta. |
ProductDetail
I dettagli del prodotto.
| Campi | |
|---|---|
section_name |
L'intestazione della sezione utilizzata per raggruppare un insieme di dettagli del prodotto. |
attribute_name |
Il nome del dettaglio del prodotto. |
attribute_value |
Il valore del dettaglio del prodotto. |
ProductDimension
La dimensione del prodotto.
| Campi | |
|---|---|
value |
Obbligatoria. Il valore della dimensione rappresentato come un numero. Il valore può avere una precisione massima di quattro cifre decimali. |
unit |
Obbligatoria. Le unità di dimensione. I valori accettati sono: * " |
ProductInput
Questa risorsa rappresenta i dati di input che invii per un prodotto, non il prodotto elaborato che vedi in Merchant Center, negli annunci Shopping o sulle piattaforme Google. Gli input dei prodotti, le regole e i dati supplementari dell'origine dati vengono combinati per creare l'elemento [product][google.shopping.content.bundles.Products.Product] elaborato.
Gli attributi di input dei prodotti obbligatori per superare i controlli di convalida dei dati sono definiti principalmente nella Specifica dei dati di prodotto.
I seguenti attributi sono obbligatori: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] e [offerId][google.shopping.content.bundles.Products.offer_id].
Dopo aver inserito, aggiornato o eliminato un input di prodotto, potrebbero essere necessari diversi minuti prima che sia possibile recuperare il prodotto elaborato.
Tutti i campi nell'input del prodotto e i relativi messaggi secondari corrispondono al nome in inglese dell'attributo corrispondente nella specifica verticale, con alcune eccezioni.
| Campi | |
|---|---|
name |
Identificatore. Il nome dell'input del prodotto. Formato: |
product |
Solo output. Il nome del prodotto elaborato. Formato: |
channel |
Obbligatoria. Immutabile. Il canale del prodotto. |
offer_id |
Obbligatoria. Immutabile. 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. Per informazioni dettagliate, consulta la specifica dei dati di prodotto. |
content_language |
Obbligatoria. Immutabile. Il codice lingua ISO 639-1 a due lettere del prodotto. |
feed_label |
Obbligatoria. Immutabile. L'etichetta del feed del prodotto. |
attributes |
Campo facoltativo. Un elenco di attributi del prodotto. |
custom_attributes[] |
Campo facoltativo. 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, |
version_number |
Campo facoltativo. 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 Supportata solo per gli inserimenti nelle origini dati principali. Se l'operazione viene impedita, verrà restituita l'eccezione interrotta. |
ProductStatus
Lo stato di un prodotto, i problemi di convalida dei dati, ovvero le informazioni su un prodotto calcolate in modo asincrono.
| Campi | |
|---|---|
destination_statuses[] |
Le destinazioni previste per il prodotto. |
item_level_issues[] |
Un elenco di tutti i problemi associati al prodotto. |
creation_date |
Data in cui è stato creato l'elemento, in formato ISO 8601. |
last_update_date |
Data dell'ultimo aggiornamento dell'articolo, in formato ISO 8601. |
google_expiration_date |
Data di scadenza dell'articolo, in formato ISO 8601. |
DestinationStatus
Lo stato della destinazione dello stato dei prodotti.
| Campi | |
|---|---|
reporting_context |
Il nome del contesto del report. |
approved_countries[] |
Elenco dei codici paese (ISO 3166-1 alpha-2) in cui l'offerta è approvata. |
pending_countries[] |
Elenco di codici paese (ISO 3166-1 alpha-2) in cui l'offerta è in attesa di approvazione. |
disapproved_countries[] |
Elenco dei codici paese (ISO 3166-1 alpha-2) in cui l'offerta non è approvata. |
ItemLevelIssue
Il valore ItemLevelIssue dello stato del prodotto.
| Campi | |
|---|---|
code |
Il codice di errore del problema. |
severity |
In che modo questo problema influisce sulla pubblicazione dell'offerta. |
resolution |
Se il problema può essere risolto dal commerciante. |
attribute |
Il nome dell'attributo, se il problema è causato da un singolo attributo. |
reporting_context |
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 per facilitare la risoluzione del problema. |
applicable_countries[] |
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. |
ProductStructuredDescription
Descrizione strutturata per descrizioni generate tramite algoritmi (IA).
| Campi | |
|---|---|
digital_source_type |
Il tipo di origine digitale, ad esempio "training_algorithmic_media". A seguito di IPTC. La lunghezza massima è di 40 caratteri. |
content |
La lunghezza massima del testo della descrizione è di 5000 caratteri |
ProductStructuredTitle
Titolo strutturato per titoli generati tramite algoritmi (IA).
| Campi | |
|---|---|
digital_source_type |
Il tipo di origine digitale, ad esempio "training_algorithmic_media". A seguito di IPTC. La lunghezza massima è di 40 caratteri. |
content |
La lunghezza massima del testo del titolo è 150 caratteri |
ProductWeight
Il peso del prodotto.
| Campi | |
|---|---|
value |
Obbligatoria. La ponderazione rappresentata come un numero. La ponderazione può avere una precisione massima di quattro cifre decimali. |
unit |
Obbligatoria. L'unità di peso. I valori accettati sono: * " |
Spedizione
La spedizione del prodotto.
| Campi | |
|---|---|
price |
Prezzo di spedizione fisso, rappresentato da un numero. |
country |
Il codice di territorio CLDR del paese in cui verrà spedito un articolo. |
region |
L'area geografica a cui si applica una tariffa di spedizione. Per ulteriori informazioni, visita la pagina relativa alla regione. |
service |
Una descrizione in formato libero della classe del servizio o della velocità di consegna. |
location_id |
L'ID numerico di una località a cui si applica la tariffa di spedizione, come definito nell'API di AdWords. |
location_group_name |
La località in cui è applicabile la spedizione, rappresentata dal nome di un gruppo di località. |
postal_code |
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. |
min_handling_time |
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]. |
max_handling_time |
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]. |
min_transit_time |
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]. |
max_transit_time |
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]. |
ShippingDimension
La dimensione di spedizione del prodotto.
| Campi | |
|---|---|
value |
La dimensione del prodotto utilizzata per calcolare il costo di spedizione dell'articolo. |
unit |
L'unità di valore. |
ShippingWeight
Il peso del pacco del prodotto.
| Campi | |
|---|---|
value |
Il peso del prodotto utilizzato per calcolare il costo di spedizione dell'articolo. |
unit |
L'unità di valore. |
SubscriptionCost
Il costo dell'abbonamento del prodotto.
| Campi | |
|---|---|
period |
Il tipo di periodo di abbonamento. I valori supportati sono: * " |
period_length |
Il numero di periodi di 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 è mese. |
YEAR |
Indica che il periodo di abbonamento è anno. |
Tasse
La tassa sul prodotto.
| Campi | |
|---|---|
rate |
La percentuale dell'aliquota fiscale applicabile al prezzo dell'articolo. |
country |
Il paese in cui l'articolo è tassato, specificato come codice di territorio CLDR. |
region |
L'area geografica a cui si applica l'aliquota fiscale. |
tax_ship |
Imposta il valore su true se viene addebitata l'imposta sulla spedizione. |
location_id |
L'ID numerico di una località a cui si applica l'aliquota fiscale, come definito nell'API di AdWords. |
postal_code |
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*. |
UnitPricingBaseMeasure
Il valore UnitPricingBaseMisura del prodotto.
| Campi | |
|---|---|
value |
Il denominatore del prezzo unitario. |
unit |
L'unità del denominatore. |
UnitPricingMeasure
L'unità di misura del prezzo unitaria del prodotto.
| Campi | |
|---|---|
value |
La misura di un elemento. |
unit |
L'unità di misura. |