REST Resource: accounts.productInputs

Risorsa: 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 delle origini dati supplementari 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 diversi 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 dell'attributo corrispondente nelle specifiche verticali, con alcune eccezioni.

Rappresentazione JSON 
{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
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~contentLanguage~feedLabel~offerId. Un esempio di nome dell'input del prodotto è "accounts/123/productInputs/online~it~IT~sku123"
product

string

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

enum (ChannelEnum)

Obbligatorio. Immutabile. Il canale del prodotto.
offerId

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

string

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

string

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

object (Attributes)

Facoltativo. Un elenco di attributi del prodotto.
customAttributes[]

object (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 il nome e il 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.
versionNumber

string (int64 format)

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

Supportato solo per le inserzioni nelle origini dati principali.

Se l'operazione viene impedita, verrà lanciata l'eccezione di interruzione.

Metodi

delete

 Consente di eliminare un dato di prodotto dal tuo account Merchant Center.

insert

 Carica un input prodotto nel tuo account Merchant Center.