REST Resource: accounts.cssProducts

Risorsa: CssProduct

Il prodotto CSS elaborato.

Rappresentazione JSON 
{
  "name": string,
  "rawProvidedId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "cssProductStatus": {
    object (CssProductStatus)
  }
}
Campi
name

string

Il nome del prodotto CSS. Formato: "accounts/{account}/cssProducts/{css_product}"
rawProvidedId

string

Solo output. Il tuo identificatore non elaborato univoco per il 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.
attributes

object (Attributes)

Solo output. Un elenco di attributi del prodotto.
customAttributes[]

object (CustomAttribute)

Solo output. Un elenco di attributi personalizzati (forniti da CSS). Può essere utilizzato anche per inviare qualsiasi attributo della specifica del feed 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.
cssProductStatus

object (CssProductStatus)

Solo output. Lo stato di un prodotto, i problemi di convalida dei dati, ovvero le informazioni su un prodotto calcolate in modo asincrono.

Attributi

Attributi per il prodotto CSS.

Rappresentazione JSON 
{
  "lowPrice": {
    object (Price)
  },
  "highPrice": {
    object (Price)
  },
  "headlineOfferPrice": {
    object (Price)
  },
  "headlineOfferShippingPrice": {
    object (Price)
  },
  "additionalImageLinks": [
    string
  ],
  "productTypes": [
    string
  ],
  "sizeTypes": [
    string
  ],
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productWeight": {
    object (ProductWeight)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productHighlights": [
    string
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "expirationDate": string,
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "headlineOfferInstallment": {
    object (HeadlineOfferInstallment)
  },
  "headlineOfferSubscriptionCost": {
    object (HeadlineOfferSubscriptionCost)
  },
  "cppLink": string,
  "cppMobileLink": string,
  "cppAdsRedirect": string,
  "numberOfOffers": string,
  "headlineOfferCondition": string,
  "headlineOfferLink": string,
  "headlineOfferMobileLink": string,
  "title": string,
  "imageLink": string,
  "description": string,
  "brand": string,
  "mpn": string,
  "gtin": string,
  "googleProductCategory": string,
  "adult": boolean,
  "multipack": string,
  "isBundle": boolean,
  "ageGroup": string,
  "color": string,
  "gender": string,
  "material": string,
  "pattern": string,
  "size": string,
  "sizeSystem": string,
  "itemGroupId": string,
  "pause": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string
}
Campi
lowPrice

object (Price)

Prezzo basso del prodotto CSS.
highPrice

object (Price)

Prezzo elevato del prodotto CSS.
headlineOfferPrice

object (Price)

Prezzo dell'offerta principale del prodotto CSS.
headlineOfferShippingPrice

object (Price)

Prezzo dell'offerta principale del prodotto CSS.
productTypes[]

string

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

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)).
productDetails[]

object (ProductDetail)

Specifiche tecniche o dettagli aggiuntivi del prodotto.
productWeight

object (ProductWeight)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductDimension)

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

string

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

object (Certification)

Un elenco di certificati rivendicati dal CSS per il prodotto in questione.
expirationDate

string (Timestamp format)

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. Nota: potrebbero essere necessari più di 2 giorni dalla data di scadenza per l'eliminazione effettiva dell'articolo.
includedDestinations[]

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

string

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

object (HeadlineOfferInstallment)

Numero e importo delle rate da pagare per un articolo.
headlineOfferSubscriptionCost

object (HeadlineOfferSubscriptionCost)

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

string

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

string (int64 format)

Il numero di prodotti CSS.
headlineOfferCondition

string

Condizione dell'offerta principale.
title

string

Titolo dell'articolo.
description

string

Descrizione dell'articolo.
brand

string

Attributi correlati al prodotto.[14-36] Marca dell'articolo.
mpn

string

Il codice parte produttore (MPN) dell'articolo.
gtin

string

Il codice Global Trade Item Number (GTIN) dell'articolo.
googleProductCategory

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

boolean

Impostato su true se l'articolo è rivolto a un pubblico adulto.
multipack

string (int64 format)

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

boolean

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

string

Fascia d'età target dell'articolo.
color

string

Colore dell'articolo.
gender

string

Genere target dell'articolo.
material

string

Il materiale di cui è composto l'articolo.
pattern

string

Il motivo dell'articolo (ad es. a pois).
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)).
sizeSystem

string

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

string

Identificatore comune a tutte le varianti di uno stesso prodotto.
pause

string

La pubblicazione di questo articolo verrà temporaneamente sospesa.
customLabel0

string

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

string

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

string

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

string

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

string

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

Prezzo

Il prezzo rappresentato come numero e valuta.

Rappresentazione JSON 
{
  "amountMicros": string,
  "currencyCode": string
}
Campi
amountMicros

string (int64 format)

Il prezzo rappresentato come numero in micro (1 milione di micro è equivalente all'unità di misura standard della valuta, ad esempio 1 $ = 1000000 micro).
currencyCode

string

La valuta del prezzo utilizzando acronimi di tre lettere secondo lo standard ISO 4217.

ProductDetail

I dettagli del prodotto.

Rappresentazione JSON 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Campi
sectionName

string

L'intestazione della sezione utilizzata per raggruppare un insieme di dettagli del prodotto.
attributeName

string

Il nome del dettaglio del prodotto.
attributeValue

string

Il valore del dettaglio del prodotto.

ProductWeight

Il peso del prodotto.

Rappresentazione JSON 
{
  "value": number,
  "unit": string
}
Campi
value

number

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"

ProductDimension

La dimensione del prodotto.

Rappresentazione JSON 
{
  "value": number,
  "unit": string
}
Campi
value

number

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"

Certificazione

La certificazione del prodotto. Utilizza questo attributo per descrivere le certificazioni associate a un prodotto, ad esempio le classi di efficienza energetica.

Rappresentazione JSON 
{
  "name": string,
  "authority": string,
  "code": string
}
Campi
name

string

Il nome della certificazione. Al momento, il valore più comune è "EPREL", che rappresenta le certificazioni di efficienza energetica presenti nel database della Banca dati europea dei prodotti per l'etichettatura energetica (EPREL).
authority

string

L'autorità o l'organismo di certificazione responsabile del rilascio della certificazione. Al momento, il valore più comune è "EC" o "European_Commission" per le etichette energetiche nell'UE.
code

string

Il codice della certificazione. Ad esempio, per il certificato EPREL a cui fa riferimento il link https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456, il codice è 123456. Il codice è obbligatorio per le etichette energetiche europee.

HeadlineOfferInstallment

Un messaggio che rappresenta la rata.

Rappresentazione JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  }
}
Campi
months

string (int64 format)

Il numero di rate che l'acquirente deve pagare.
amount

object (Price)

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

object (Price)

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

HeadlineOfferSubscriptionCost

Il valore SubscriptionCost del prodotto.

Rappresentazione JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Campi
period

enum (SubscriptionPeriod)

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

string (int64 format)

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

object (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.

CustomAttribute

Un messaggio che rappresenta gli attributi personalizzati. Esattamente uno tra value o groupValues non deve essere vuoto.

Rappresentazione JSON 
{
  "groupValues": [
    {
      object (CustomAttribute)
    }
  ],
  "name": string,
  "value": string
}
Campi
groupValues[]

object (CustomAttribute)

Attributi secondari all'interno di questo gruppo di attributi. Se groupValues non è vuoto, value deve essere vuoto.
name

string

Il nome dell'attributo.
value

string

Il valore dell'attributo. Se value non è vuoto, groupValues deve essere vuoto.

CssProductStatus

Lo stato del prodotto CSS, i problemi di convalida dei dati, ovvero le informazioni sul prodotto CSS 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 
{
  "destination": string,
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Campi
destination

string

Il nome della destinazione
approvedCountries[]

string

Elenco dei codici paese (ISO 3166-1 alpha-2) in cui il prodotto CSS è approvato.
pendingCountries[]

string

Elenco dei codici paese (ISO 3166-1 alpha-2) in cui il prodotto CSS è in attesa di approvazione.
disapprovedCountries[]

string

Elenco dei codici paese (ISO 3166-1 alpha-2) in cui il prodotto CSS non è approvato.

ItemLevelIssue

Il problema a livello di articolo dello stato del prodotto.

Rappresentazione JSON 
{
  "code": string,
  "servability": string,
  "resolution": string,
  "attribute": string,
  "destination": string,
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Campi
code

string

Il codice di errore del problema.
servability

string

In che modo questo problema influisce sulla pubblicazione del prodotto CSS.
resolution

string

Se il problema può essere risolto dal commerciante.
attribute

string

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

string

La destinazione 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 al prodotto CSS.

Metodi

get

 Recupera il prodotto CSS elaborato dal tuo account CSS Center.

list

 Elenca i prodotti CSS elaborati nel tuo account CSS Center.