REST Resource: accounts.products

Risorsa: 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.

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}}", dove l'ultima sezione product è composta da 4 parti: channel~contentLanguage~feedLabel~offerId. Un esempio di nome del prodotto è "accounts/123/products/online~it~IT~sku123"
channel

enum (ChannelEnum)

Solo output. Il canale del prodotto.
offerId

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

string

Solo output. Il codice lingua ISO 639-1 di 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 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.
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 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.

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 di creazione dell'elemento, nel formato ISO 8601.
lastUpdateDate

string (Timestamp format)

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

string (Timestamp format)

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

DestinationStatus

Lo stato di destinazione dello stato del prodotto.

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

enum (ReportingContextEnum)

Il nome del contesto report.
approvedCountries[]

string

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

string

Elenco dei 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 problema a livello di articolo 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

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

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.

Metodi

get

 Recupera il prodotto elaborato dal tuo account Merchant Center.

list

 Elenca i prodotti elaborati nel tuo account Merchant Center.