Method: accounts.productInputs.insert

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.

Richiesta HTTP

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

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

Parametri di ricerca

Parametri
dataSource

string

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

Corpo della richiesta

Il corpo della richiesta contiene un'istanza di ProductInput.

Corpo della risposta

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.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

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}}"
product

string

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

enum (ChannelEnum)

Obbligatoria. Immutabile. Il canale del prodotto.
offerId

string

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

string

Obbligatoria. Immutabile. Il codice lingua ISO 639-1 a due lettere del prodotto.
feedLabel

string

Obbligatoria. Immutabile. L'etichetta del feed del prodotto.
attributes

object (Attributes)

Campo facoltativo. Un elenco di attributi del prodotto.
customAttributes[]

object (CustomAttribute)

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

string (int64 format)

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

Supportata solo per gli inserimenti nelle origini dati principali.

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

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la panoramica di OAuth 2.0.