Package google.shopping.merchant.products.v1beta

Indice

ProductInputsService

Servizio per utilizzare la risorsa ProductInput. Questo servizio è disponibile solo per i prodotti con canale online.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

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.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

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.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

Servizio prodotti

Servizio per utilizzare la risorsa Prodotto. Questo servizio è disponibile solo per i prodotti con canale online.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

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.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

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.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/content

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

Attributi

Attributi.

Campi
expiration_date

Timestamp

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

disclosure_date

Timestamp

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_date

Timestamp

Il giorno in cui il prodotto pre-ordinato diventa disponibile per la consegna, in formato ISO 8601.

gtin[]

string

I codici Global Trade Item Number (GTIN) dell'articolo. Puoi fornire fino a 10 GTIN.

price

Price

Prezzo dell'articolo.

installment

Installment

Numero e importo delle rate da pagare per un articolo.

subscription_cost

SubscriptionCost

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

loyalty_points

LoyaltyPoints

Punti fedeltà che gli utenti ricevono dopo l'acquisto dell'articolo. Solo in Giappone.

loyalty_programs[]

LoyaltyProgram

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_types[]

string

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

sale_price

Price

Prezzo scontato pubblicizzato dell'articolo.

sale_price_effective_date

Interval

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

product_height

ProductDimension

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

product_length

ProductDimension

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

product_width

ProductDimension

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

product_weight

ProductWeight

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

shipping[]

Shipping

Regole di spedizione.

free_shipping_threshold[]

FreeShippingThreshold

Condizioni da soddisfare per poter usufruire della spedizione gratuita per un prodotto.

shipping_weight

ShippingWeight

Peso dell'articolo per la spedizione.

shipping_length

ShippingDimension

Lunghezza dell'articolo per la spedizione.

shipping_width

ShippingDimension

Larghezza dell'articolo per la spedizione.

shipping_height

ShippingDimension

Altezza dell'articolo per la spedizione.

size_types[]

string

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

Tax

Dati fiscali.

unit_pricing_measure

UnitPricingMeasure

La misura e la dimensione di un articolo.

unit_pricing_base_measure

UnitPricingBaseMeasure

La preferenza del denominatore del prezzo unitario.

ads_labels[]

string

Simile ad ads_grouping, ma funziona solo con il CPC.

cost_of_goods_sold

Price

Costo del venduto. Utilizzato per i report sul margine lordo.

product_details[]

ProductDetail

Specifiche tecniche o dettagli aggiuntivi del prodotto.

product_highlights[]

string

Punti elenco che descrivono le caratteristiche più pertinenti di un prodotto.

display_ads_similar_ids[]

string

Consigli specificati dall'inserzionista.

promotion_ids[]

string

L'ID univoco di una promozione.

included_destinations[]

string

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

excluded_destinations[]

string

L'elenco delle destinazioni da escludere per questo target (corrisponde alle caselle di controllo non selezionate in Merchant Center).

shopping_ads_excluded_countries[]

string

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.

cloud_export_additional_properties[]

CloudExportAdditionalProperties

Campi aggiuntivi da esportare nel programma Cloud per la vendita al dettaglio.

certifications[]

Certification

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_pricing_min_price

Price

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_incentives[]

ProductSustainabilityIncentive

L'elenco dei programmi di incentivi per la sostenibilità.

identifier_exists

bool

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_bundle

bool

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

string

Titolo dell'articolo.

description

string

Descrizione dell'articolo.

adult

bool

Impostato su true se l'articolo è destinato agli adulti.

age_group

string

Fascia d'età target dell'articolo.

availability

string

Stato di disponibilità dell'articolo.

brand

string

Marca dell'articolo.

color

string

Colore dell'articolo.

condition

string

Condizione o stato dell'articolo.

gender

string

Genere target dell'articolo.

google_product_category

string

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_group_id

string

Identificatore comune a tutte le varianti di uno stesso prodotto.

material

string

Il materiale di cui è composto l'articolo.

mpn

string

Il codice parte produttore (MPN) dell'articolo.

pattern

string

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

sell_on_google_quantity

int64

La quantità di prodotto disponibile per la vendita su Google. Supportato solo per i prodotti online.

max_handling_time

int64

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

min_handling_time

int64

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

shipping_label

string

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

transit_time_label

string

L'etichetta del tempo di transito del prodotto, utilizzata per raggruppare i prodotti nelle tabelle dei tempi 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 (vedi [https://support.google.com/merchants/answer/6324492](definizione della taglia)).

size_system

string

Sistema in cui è specificata la taglia. Consigliato per gli articoli di abbigliamento.

tax_category

string

La categoria fiscale del prodotto.

energy_efficiency_class

string

La classe energetica come definita dalla direttiva UE 2010/30/UE.

min_energy_efficiency_class

string

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

max_energy_efficiency_class

string

La classe energetica come definita dalla direttiva UE 2010/30/UE.

multipack

int64

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

ads_grouping

string

Utilizzato per raggruppare gli articoli in modo arbitrario. Solo per il CPA%; sconsigliato in caso contrario.

ads_redirect

string

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

display_ads_id

string

L'identificatore di un articolo per le campagne di remarketing dinamico.

display_ads_title

string

Titolo di un articolo per le campagne di remarketing dinamico.

display_ads_value

double

Margine di offerta per le campagne di remarketing dinamico.

pickup_method

string

L'opzione di ritiro dell'articolo.

pickup_sla

string

Tempistiche per il ritiro dell'articolo in negozio.

custom_label_0

string

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

custom_label_1

string

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

custom_label_2

string

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

custom_label_3

string

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

custom_label_4

string

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

external_seller_id

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 articolo verrà messa in pausa temporaneamente.

structured_title

ProductStructuredTitle

Titolo strutturato, per i titoli creati con l'algoritmo (IA).

structured_description

ProductStructuredDescription

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_authority

string

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

certification_name

string

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

certification_code

string

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

certification_value

string

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_value[]

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 è di 256 caratteri.

int_value[]

int64

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

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_name

string

Nome della proprietà specificata. Ad esempio, "Screen-Resolution" per un prodotto TV. La dimensione massima della stringa è di 256 caratteri.

bool_value

bool

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

min_value

float

Valore minimo del tipo float della proprietà specificata. Ad esempio, per un prodotto TV 1.00.

max_value

float

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

unit_code

string

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

string

Obbligatorio. Il nome della risorsa di input del prodotto da eliminare. Formato: accounts/{account}/productInputs/{product}, dove l'ultima sezione product è composta da 4 parti: channel~content_language~feed_label~offer_id. Un esempio di nome del prodotto è "accounts/123/productInputs/online~en~US~sku123"

data_source

string

Obbligatorio. L'origine dati principale o supplementare da cui deve essere eliminato l'input del prodotto. Formato: accounts/{account}/dataSources/{datasource}.

FreeShippingThreshold

Condizioni da soddisfare per poter usufruire della spedizione gratuita per un prodotto.

Campi
country

string

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

price_threshold

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

string

Obbligatorio. Il nome del prodotto da recuperare. Formato: accounts/{account}/products/{product}, dove l'ultima sezione product è composta da 4 parti: channel~content_language~feed_label~offer_id. Un esempio di nome del prodotto è "accounts/123/products/online~it~IT~sku123"

InsertProductInputRequest

Messaggio di richiesta per il metodo InsertProductInput.

Campi
parent

string

Obbligatorio. L'account in cui verrà inserito questo prodotto. Formato: accounts/{account}

product_input

ProductInput

Obbligatorio. L'input del prodotto da inserire.

data_source

string

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: accounts/{account}/dataSources/{datasource}.

Rata

Un messaggio che rappresenta la rata.

Campi
months

int64

Il numero di rate che l'acquirente deve pagare.

amount

Price

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

downpayment

Price

L'importo dell'acconto anticipato che l'acquirente deve pagare.

credit_type

string

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

ListProductsRequest

Messaggio di richiesta per il metodo ListProducts.

Campi
parent

string

Obbligatorio. L'account per cui elencare i prodotti elaborati. Formato: accounts/{account}

page_size

int32

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_token

string

Un token di pagina ricevuto da una chiamata ListProducts precedente. Fornisci questo valore per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListProducts devono corrispondere alla chiamata che ha fornito il token pagina.

ListProductsResponse

Messaggio di risposta per il metodo ListProducts.

Campi
products[]

Product

I prodotti elaborati dall'account specificato. Si tratta dei prodotti elaborati dopo l'applicazione di regole e origini dati supplementari.

next_page_token

string

Un token che può essere inviato come page_token per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.

LoyaltyPoints

Un messaggio che rappresenta i punti fedeltà.

Campi
name

string

Nome del programma fedeltà a punti. Si consiglia di limitare il nome a 12 caratteri standard o 24 caratteri romani.

points_value

int64

I punti fedeltà del rivenditore in valore assoluto.

ratio

double

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_label

string

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_label

string

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

price

Price

Il prezzo per i membri del livello specificato, ovvero il prezzo scontato istantaneo. Deve essere inferiore o uguale al prezzo normale.

cashback_for_future_use

Price

Il cashback che può essere utilizzato per acquisti futuri.

loyalty_points

int64

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

member_price_effective_date

Interval

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_label

string

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

string

Il nome del prodotto. Formato: "{product.name=accounts/{account}/products/{product}}", dove l'ultima sezione product è composta da 4 parti: channel~content_language~feed_label~offer_id. Un esempio di nome del prodotto è "accounts/123/products/online~it~IT~sku123"

channel

ChannelEnum

Solo output. Il canale del prodotto.

offer_id

string

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_language

string

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

feed_label

string

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

data_source

string

Solo output. L'origine dati principale del prodotto.

attributes

Attributes

Solo output. Un elenco di attributi del prodotto.

custom_attributes[]

CustomAttribute

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. { "name": "size type", "value": "regular" }). Questo è utile per inviare attributi non esposti esplicitamente dall'API, come gli attributi aggiuntivi utilizzati per Acquista su Google.

product_status

ProductStatus

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

int64

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'version_number attuale.

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_name

string

La sezione di intestazione utilizzata per raggruppare un insieme di dettagli del prodotto.

attribute_name

string

Il nome del dettaglio del prodotto.

attribute_value

string

Il valore del dettaglio del prodotto.

ProductDimension

La dimensione del prodotto.

Campi
value

double

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

unit

string

Obbligatorio. Le unità di misura delle dimensioni. I valori accettati sono: * "in" * "cm"

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

string

Identificatore. Il nome dell'input del prodotto. Formato: "{productinput.name=accounts/{account}/productInputs/{productinput}}", dove l'ultima sezione productinput è composta da 4 parti: channel~content_language~feed_label~offer_id. Un esempio di nome dell'input del prodotto è "accounts/123/productInputs/online~it~IT~sku123"

product

string

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

channel

ChannelEnum

Immutabile. Il canale del prodotto.

offer_id

string

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_language

string

Obbligatorio. Immutabile. Il codice lingua ISO 639-1 di due lettere del prodotto.

feed_label

string

Obbligatorio. Immutabile. L'etichetta del feed per il prodotto.

attributes

Attributes

Facoltativo. Un elenco di attributi del prodotto.

custom_attributes[]

CustomAttribute

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. { "name": "size type", "value": "regular" }). Questo è utile per inviare attributi non esposti esplicitamente dall'API, come gli attributi aggiuntivi utilizzati per Acquista su Google. Il numero massimo di caratteri consentito per ogni attributo personalizzato è 10240 (rappresenta la somma dei caratteri per nome e valore). È possibile impostare un massimo di 2500 attributi personalizzati per prodotto, con dimensioni totali di 102,4 kB. I trattini bassi nei nomi degli attributi personalizzati vengono sostituiti da spazi al momento dell'inserimento.

version_number

int64

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'version_number attuale.

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_statuses[]

DestinationStatus

Le destinazioni previste per il prodotto.

item_level_issues[]

ItemLevelIssue

Un elenco di tutti i problemi associati al prodotto.

creation_date

Timestamp

Data di creazione dell'elemento, nel formato ISO 8601.

last_update_date

Timestamp

Data dell'ultimo aggiornamento dell'elemento, in formato ISO 8601.

google_expiration_date

Timestamp

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

DestinationStatus

Lo stato di destinazione dello stato del prodotto.

Campi
reporting_context

ReportingContextEnum

Il nome del contesto report.

approved_countries[]

string

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

pending_countries[]

string

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

disapproved_countries[]

string

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

string

Il codice di errore del problema.

severity

Severity

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

resolution

string

Indica se il problema può essere risolto dal commerciante.

attribute

string

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

reporting_context

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 che possa aiutarci a risolvere il problema.

applicable_countries[]

string

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_source_type

string

Il tipo di origine digitale, ad esempio "trained_algorithmic_media". Secondo le specifiche IPTC. La lunghezza massima è di 40 caratteri.

content

string

La lunghezza massima del testo della descrizione è di 5000 caratteri

ProductStructuredTitle

Titolo strutturato, per i titoli creati con l'algoritmo (IA).

Campi
digital_source_type

string

Il tipo di origine digitale, ad esempio "trained_algorithmic_media". Secondo le specifiche IPTC. La lunghezza massima è di 40 caratteri.

content

string

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

Price

L'importo fisso dell'incentivo.

percentage

double

La percentuale del prezzo scontato a cui si applica lo sconto.

type

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

double

Obbligatorio. La ponderazione rappresentata come numero. Il peso può avere una precisione massima di quattro cifre decimali.

unit

string

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

Spedizione

La spedizione del prodotto.

Campi
price

Price

Prezzo di spedizione fisso, rappresentato come numero.

country

string

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

region

string

La regione geografica a cui si applica una tariffa di spedizione. Per ulteriori informazioni, consulta regione.

service

string

Una descrizione libera della classe del servizio o della velocità di consegna.

location_id

int64

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

location_group_name

string

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

postal_code

string

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_handling_time

int64

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. minHandlingTime può essere presente solo insieme a maxHandlingTime, ma non è obbligatorio se è presente maxHandlingTime.

max_handling_time

int64

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 maxHandlingTime che maxTransitTime sono obbligatori se fornisci le velocità di spedizione. minHandlingTime è facoltativo se è presente maxHandlingTime.

min_transit_time

int64

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. minTransitTime può essere presente solo insieme a maxTransitTime, ma non è obbligatorio se è presente maxTransitTime.

max_transit_time

int64

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 maxHandlingTime che maxTransitTime sono obbligatori se fornisci le velocità di spedizione. minTransitTime è facoltativo se è presente maxTransitTime.

ShippingDimension

La dimensione ShippingDimension del prodotto.

Campi
value

double

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

unit

string

L'unità di valore.

ShippingWeight

Il valore ShippingWeight del prodotto.

Campi
value

double

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

unit

string

L'unità di valore.

SubscriptionCost

Il valore SubscriptionCost del prodotto.

Campi
period

SubscriptionPeriod

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

period_length

int64

Il numero di periodi di validità dell'abbonamento che l'acquirente deve pagare.

amount

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

Imposta

L'IVA del prodotto.

Campi
rate

double

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

country

string

Il paese in cui l'articolo è soggetto a tassazione, specificato come codice di territorio CLDR.

region

string

La regione geografica a cui si applica l'aliquota fiscale.

tax_ship

bool

Imposta su true se le imposte vengono addebitate sulla spedizione.

location_id

int64

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

postal_code

string

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

int64

Il denominatore del prezzo unitario.

unit

string

L'unità del denominatore.

UnitPricingMeasure

La misura UnitPricingMeasure del prodotto.

Campi
value

double

La misura di un articolo.

unit

string

L'unità di misura.