Package google.shopping.css.v1

Indice

AccountLabelsService

Gestisce le etichette degli account Merchant Center e CSS.

CreateAccountLabel

rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)

Crea una nuova etichetta, non assegnata a nessun account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

DeleteAccountLabel

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

Elimina un'etichetta e la rimuove da tutti gli account a cui era assegnata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

ListAccountLabels

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

Elenca le etichette di proprietà di un account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

UpdateAccountLabel

rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)

Aggiorna un'etichetta.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

AccountsService

Servizio per la gestione delle informazioni dell'account CSS/AMC.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Recupera un singolo account CSS/MC per ID.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

ListChildAccounts

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

Elenca tutti gli account con l'ID account CSS specificato e, facoltativamente, filtra per ID etichetta e nome account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

UpdateLabels

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

Aggiorna le etichette assegnate agli account CSS/MC da un dominio CSS.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

CssProductInputsService

Servizio da utilizzare per la risorsa CssProductInput. Questo servizio consente di inserire, aggiornare ed eliminare i prodotti CSS.

DeleteCssProductInput

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

Elimina un input di prodotto CSS dal tuo account CSS Center.

Dopo l'eliminazione, potrebbero essere necessari diversi minuti prima che l'input non sia più disponibile.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

InsertCssProductInput

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

Carica un CssProductInput nel tuo account CSS Center. Se esiste già un input con gli stessi valori di contentLanguage, identity, feedLabel e feedId, questo metodo sostituisce la voce.

Dopo aver inserito, aggiornato o eliminato un input di prodotto CSS, potrebbero essere necessari diversi minuti prima che sia possibile recuperare il prodotto CSS elaborato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

UpdateCssProductInput

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

Aggiorna l'input Prodotto CSS esistente nel tuo account CSS Center.

Dopo aver inserito, aggiornato o eliminato un input di prodotto CSS, potrebbero essere necessari diversi minuti prima che sia possibile recuperare il prodotto CSS elaborato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

CssProductsService

Servizio per eseguire operazioni di recupero ed elenco sui prodotti CSS(ovvero offerte aggregate internamente).

GetCssProduct

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

Recupera il prodotto CSS elaborato dal tuo account CSS Center. Dopo aver inserito, aggiornato o eliminato un input di prodotto, potrebbero essere necessari diversi minuti prima che sia possibile recuperare il prodotto finale aggiornato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

ListCssProducts

rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)

Elenca i prodotti CSS elaborati nel tuo account CSS Center. La risposta potrebbe contenere meno elementi di quelli specificati da pageSize. Utilizza pageToken per determinare se sono presenti altri elementi da richiedere.

Dopo aver inserito, aggiornato o eliminato un input di prodotto CSS, potrebbero essere necessari diversi minuti prima che sia possibile recuperare il prodotto CSS elaborato aggiornato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

QuotaService

Servizio per ottenere informazioni sulla quota di chiamate al metodo per metodo API CSS.

ListQuotaGroups

rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)

Elenca la quota e l'utilizzo giornalieri delle chiamate per gruppo per il tuo account CSS Center.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per saperne di più, consulta la OAuth 2.0 Overview.

Account

Informazioni sull'account CSS/MC.

Campi
name

string

Il nome della risorsa dell'etichetta. Formato: accounts/{account}

full_name

string

Solo output. Immutabile. Il nome completo dell'account CSS/MC.

label_ids[]

int64

ID etichetta creati manualmente assegnati all'account CSS/MC da un account principale CSS.

automatic_label_ids[]

int64

ID etichetta creati automaticamente assegnati all'account MC da CSS Center.

account_type

AccountType

Solo output. Il tipo di account.

display_name

string

Il nome visualizzato breve dell'account CSS/MC.

homepage_uri

string

Solo output. Immutabile. La home page dell'account CSS/MC.

parent

string

La risorsa padre dell'account CSS/MC. Gruppo di CSS per i domini CSS; dominio CSS per gli account multi-cliente. Restituito solo se l'utente ha accesso all'account genitore. Nota: per i subaccount MC, questo è anche il dominio CSS che è la risorsa padre dell'account AMC, poiché stiamo appiattendo la gerarchia."

AccountType

Il tipo di account.

Enum
ACCOUNT_TYPE_UNSPECIFIED Tipo di account sconosciuto.
CSS_GROUP Account del gruppo di CSS.
CSS_DOMAIN Account del dominio CSS.
MC_PRIMARY_CSS_MCA Account AMC CSS principale MC.
MC_CSS_MCA Account AMC CSS multi-cliente.
MC_MARKETPLACE_MCA Account AMC marketplace MC.
MC_OTHER_MCA Account MC Altro AMC.
MC_STANDALONE Account MC autonomo.
MC_MCA_SUBACCOUNT Subaccount AMC MC.

AccountLabel

Etichetta assegnata dal dominio CSS o dal gruppo di CSS a uno dei suoi subaccount.

Campi
name

string

Identificatore. Il nome della risorsa dell'etichetta. Formato: accounts/{account}/labels/{label}

label_id

int64

Solo output. L'ID dell'etichetta.

account_id

int64

Solo output. L'ID dell'account a cui appartiene questa etichetta.

label_type

LabelType

Solo output. Il tipo di questa etichetta.

display_name

string

Il nome visualizzato di questa etichetta.

description

string

La descrizione di questa etichetta.

LabelType

Il tipo di etichetta.

Enum
LABEL_TYPE_UNSPECIFIED Tipo di etichetta sconosciuto.
MANUAL Indica che l'etichetta è stata creata manualmente.
AUTOMATIC Indica che l'etichetta è stata creata automaticamente da CSS Center.

Attributi

Attributi per il prodotto CSS.

Campi
low_price

Price

Prezzo basso del prodotto CSS.

high_price

Price

Prezzo elevato del prodotto CSS.

headline_offer_price

Price

Prezzo principale del prodotto CSS.

headline_offer_shipping_price

Price

Prezzo principale del prodotto CSS.

product_types[]

string

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

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 tipo di taglia).

product_details[]

ProductDetail

Specifiche tecniche o dettagli aggiuntivi del prodotto.

product_weight

ProductWeight

Il peso del prodotto nelle unità fornite. Il valore deve essere compreso tra 0 (escluso) e 2000 (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_height

ProductDimension

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

product_highlights[]

string

Elenco puntato che descrive le caratteristiche più rilevanti di un prodotto.

certifications[]

Certification

Un elenco di certificati rivendicati dal CSS per il prodotto specificato.

expiration_date

Timestamp

La data di scadenza dell'elemento, come specificato al momento dell'inserimento, nel formato ISO 8601. La data di scadenza effettiva è esposta in productstatuses come googleExpirationDate e potrebbe essere precedente se expirationDate è troppo lontano nel futuro. Nota: potrebbero essere necessari più di due giorni dalla data di scadenza prima che l'elemento venga effettivamente eliminato.

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 a caselle di controllo non selezionate in Merchant Center).

headline_offer_installment

HeadlineOfferInstallment

Numero e importo delle rate da pagare per un articolo.

headline_offer_subscription_cost

HeadlineOfferSubscriptionCost

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

cpp_ads_redirect

string

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

number_of_offers

int64

Il numero di prodotti CSS.

headline_offer_condition

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.

google_product_category

string

La categoria dell'articolo di Google (vedi la 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

bool

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

multipack

int64

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

is_bundle

bool

Indica se l'articolo è un set definito dal commerciante. Un set è un raggruppamento personalizzato di prodotti diversi venduti da un commerciante a un prezzo unico.

age_group

string

Età degli utenti a cui è destinato l'articolo.

color

string

Il 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)).

size_system

string

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

item_group_id

string

Identificatore comune a tutte le varianti di uno stesso prodotto.

pause

string

La pubblicazione di questo elemento verrà temporaneamente sospesa.

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 articoli in una campagna Shopping.

review_count

int64

Numero di recensioni del prodotto. Obbligatorio se viene fornito rating. Questo campo è destinato a una funzionalità futura e non è ancora utilizzato.

min_rating

int64

Punteggio di valutazione minimo del prodotto. Obbligatorio se viene fornito rating. Questo campo è destinato a una funzionalità futura e non è ancora utilizzato.

max_rating

int64

Punteggio di valutazione massimo del prodotto. Obbligatorio se viene fornito rating. Questo campo è destinato a una funzionalità futura e non è ancora utilizzato.

rating

double

Punteggio medio di valutazione del prodotto. Il valore deve essere compreso nell'intervallo [min_rating, max_rating] inclusi. Quando viene visualizzata nella pagina di prodotto, questa valutazione viene normalizzata su una scala da 1 a 5 con una cifra decimale. Se forniti, sono obbligatori anche review_count, min_rating e max_rating. Questo campo è destinato a una funzionalità futura e non è ancora utilizzato.

Certificazione

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

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) dell'UE.

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.

CreateAccountLabelRequest

Messaggio di richiesta per il metodo "CreateAccountLanel".

Campi
parent

string

Obbligatorio. L'account principale. Formato: accounts/{account}

account_label

AccountLabel

Obbligatorio. L'etichetta da creare.

CssProduct

Il prodotto CSS elaborato.

Campi
name

string

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

raw_provided_id

string

Solo output. Il tuo identificatore non elaborato univoco per il prodotto.

content_language

string

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

feed_label

string

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

attributes

Attributes

Solo output. Un elenco di attributi prodotto.

custom_attributes[]

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

css_product_status

CssProductStatus

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

CssProductInput

Questa risorsa rappresenta i dati di input che invii per un prodotto CSS, non il prodotto CSS elaborato che vedi in CSS Center, negli annunci Shopping o sulle piattaforme Google.

Campi
name

string

Identificatore. Il nome dell'input Prodotto CSS. Formato: accounts/{account}/cssProductInputs/{css_product_input}, dove l'ultima sezione css_product_input è composta da tre parti: contentLanguage~feedLabel~offerId. Esempio: accounts/123/cssProductInputs/de~DE~rawProvidedId123

final_name

string

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

raw_provided_id

string

Obbligatorio. Il tuo identificatore univoco per il prodotto CSS. Lo stesso vale per l'input del prodotto CSS e il prodotto CSS elaborato. Consentiamo solo ID con caratteri alfanumerici, trattini bassi e trattini. Per maggiori dettagli, consulta la specifica dei feed di prodotto.

content_language

string

Obbligatorio. Il codice lingua ISO 639-1 di due lettere per il prodotto CSS.

feed_label

string

Obbligatorio. L'etichetta del feed per il prodotto CSS. L'etichetta del feed è sinonimo di "paese di destinazione" e pertanto deve sempre essere un codice regione valido. Ad esempio, "DE" per la Germania, "FR" per la Francia.

freshness_time
(deprecated)

Timestamp

OBSOLETO. Utilizza invece expiration_date. Rappresenta la versione esistente (aggiornamento) del prodotto CSS, che può essere utilizzata per mantenere l'ordine corretto quando vengono eseguiti più aggiornamenti contemporaneamente.

Questo campo non deve essere impostato su un orario futuro.

Se impostato, l'aggiornamento viene impedito se nel nostro sistema esiste già una versione più recente dell'articolo (ovvero l'ora dell'ultimo aggiornamento dei prodotti CSS esistenti è successiva all'ora di aggiornamento impostata). Se l'aggiornamento viene eseguito, l'ora dell'ultimo aggiornamento viene impostata su questa ora di aggiornamento.

Se non viene impostato, l'aggiornamento non verrà impedito e l'ora dell'ultimo aggiornamento verrà impostata per impostazione predefinita al momento della ricezione di questa richiesta da parte dell'API CSS.

Se l'operazione viene impedita, viene generata l'eccezione di interruzione.

attributes

Attributes

Un elenco degli attributi dei prodotti CSS.

custom_attributes[]

CustomAttribute

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

CssProductStatus

Lo stato del prodotto CSS, i problemi di convalida dei dati, ovvero le informazioni sul prodotto CSS 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

La data di creazione dell'elemento, nel formato ISO 8601.

last_update_date

Timestamp

La data dell'ultimo aggiornamento dell'articolo, in formato ISO 8601.

google_expiration_date

Timestamp

La data di scadenza dell'articolo, nel formato ISO 8601.

DestinationStatus

Lo stato della destinazione dello stato del prodotto.

Campi
destination

string

Il nome della destinazione

approved_countries[]

string

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

pending_countries[]

string

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

disapproved_countries[]

string

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

ItemLevelIssue

ItemLevelIssue dello stato del prodotto.

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

applicable_countries[]

string

Elenco dei codici paese (ISO 3166-1 alpha-2) in cui il problema riguarda il prodotto CSS.

DeleteAccountLabelRequest

Messaggio di richiesta per il metodo "DeleteAccountLabel".

Campi
name

string

Obbligatorio. Il nome dell'etichetta da eliminare. Formato: accounts/{account}/labels/{label}

DeleteCssProductInputRequest

Messaggio di richiesta per il metodo DeleteCssProductInput.

Campi
name

string

Obbligatorio. Il nome della risorsa di input del prodotto CSS da eliminare. Formato: accounts/{account}/cssProductInputs/{css_product_input}, dove l'ultima sezione css_product_input è composta da tre parti: contentLanguage~feedLabel~offerId. Esempio: accounts/123/cssProductInputs/de~DE~rawProvidedId123

supplemental_feed_id

int64

L'ID feed supplementare di API Content. Il campo non deve essere impostato se l'azione si applica a un feed principale. Se il campo è impostato, l'azione sul prodotto si applica a un feed supplementare anziché al feed principale di API Content.

GetAccountRequest

Il messaggio di richiesta per il metodo GetAccount.

Campi
name

string

Obbligatorio. Il nome dell'account CSS/MC gestito. Formato: accounts/{account}

parent

string

Facoltativo. Obbligatorio solo per il recupero delle informazioni dell'account MC. Il dominio CSS che è la risorsa padre dell'account MC. Formato: accounts/{account}

GetCssProductRequest

Il messaggio di richiesta per il metodo GetCssProduct.

Campi
name

string

Obbligatorio. Il nome del prodotto CSS da recuperare. Formato: accounts/{account}/cssProducts/{css_product}

HeadlineOfferInstallment

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 iniziale che l'acquirente deve pagare.

HeadlineOfferSubscriptionCost

Il costo dell'abbonamento al 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 periodo di abbonamento.

InsertCssProductInputRequest

Messaggio di richiesta per il metodo InsertCssProductInput.

Campi
parent

string

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

css_product_input

CssProductInput

Obbligatorio. L'input del prodotto CSS da inserire.

feed_id
(deprecated)

int64

Facoltativo. OBSOLETO. L'ID feed non è obbligatorio per i prodotti CSS. L'ID del feed principale o supplementare. Se il prodotto CSS esiste già e l'ID feed fornito è diverso, il prodotto CSS verrà spostato in un nuovo feed. Nota: per il momento, i CSS non devono fornire ID feed perché creiamo i feed al volo. Al momento non supportiamo i feed supplementari per i prodotti CSS.

ListAccountLabelsRequest

Messaggio di richiesta per il metodo ListAccountLabels.

Campi
parent

string

Obbligatorio. L'account principale. Formato: accounts/{account}

page_size

int32

Il numero massimo di etichette da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non è specificato, verranno restituite al massimo 50 etichette. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000.

page_token

string

Un token di pagina, ricevuto da una precedente chiamata ListAccountLabels. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a ListAccountLabels devono corrispondere alla chiamata che ha fornito il token di pagina.

ListAccountLabelsResponse

Messaggio di risposta per il metodo ListAccountLabels.

Campi
account_labels[]

AccountLabel

Le etichette dell'account specificato.

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.

ListChildAccountsRequest

Il messaggio di richiesta per il metodo ListChildAccounts.

Campi
parent

string

Obbligatorio. L'account principale. Deve essere un gruppo di CSS o un dominio. Formato: accounts/{account}

page_size

int32

Facoltativo. Il numero massimo di account da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Se non specificato, verranno restituiti al massimo 50 account. Il valore massimo è 100; i valori superiori a 100 verranno forzati a 100.

page_token

string

Facoltativo. Un token di pagina, ricevuto da una precedente chiamata ListChildAccounts. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a ListChildAccounts devono corrispondere alla chiamata che ha fornito il token di pagina.

label_id

int64

Se impostato, verranno restituiti solo gli account MC con l'ID etichetta specificato.

full_name

string

Se impostato, verranno restituiti solo gli account MC con il nome specificato (sensibile alle maiuscole).

ListChildAccountsResponse

Messaggio di risposta per il metodo ListChildAccounts.

Campi
accounts[]

Account

Gli account CSS/MC restituiti per l'account principale CSS specificato.

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.

ListCssProductsRequest

Messaggio di richiesta per il metodo ListCssProducts.

Campi
parent

string

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

page_size

int32

Il numero massimo di prodotti CSS da restituire. Il servizio potrebbe restituire un numero inferiore a questo valore. Il valore massimo è 1000; i valori superiori a 1000 verranno forzati a 1000. Se non specificato, verrà restituito il numero massimo di prodotti CSS.

page_token

string

Un token di pagina, ricevuto da una precedente chiamata ListCssProducts. Forniscilo per recuperare la pagina successiva.

Durante la paginazione, tutti gli altri parametri forniti a ListCssProducts devono corrispondere alla chiamata che ha fornito il token di pagina.

ListCssProductsResponse

Messaggio di risposta per il metodo ListCssProducts.

Campi
css_products[]

CssProduct

I prodotti CSS elaborati dell'account specificato. Questi sono i tuoi prodotti CSS elaborati dopo l'applicazione di regole e feed 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.

ListQuotaGroupsRequest

Messaggio di richiesta per il metodo ListQuotaGroups.

Campi
parent

string

Obbligatorio. L'account CSS proprietario della raccolta di quote e risorse dei metodi. Nella maggior parte dei casi, si tratta del dominio CSS. Formato: accounts/{account}

page_size

int32

Facoltativo. Il numero massimo di quote da restituire nella risposta, utilizzato per la paginazione. Il valore predefinito è 500; i valori superiori a 1000 verranno forzati a 1000.

page_token

string

Facoltativo. Token (se fornito) per recuperare la pagina successiva. Tutti gli altri parametri devono corrispondere alla chiamata originale che ha fornito il token di pagina.

ListQuotaGroupsResponse

Messaggio di risposta per il metodo ListMethodGroups.

Campi
quota_groups[]

QuotaGroup

I metodi, l'utilizzo attuale della quota e i limiti per ogni gruppo. La quota è condivisa tra tutti i metodi del gruppo. I gruppi sono ordinati in ordine decrescente in base a quota_usage.

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.

MethodDetails

I dettagli del metodo per ogni metodo nell'API CSS.

Campi
method

string

Solo output. Il nome del metodo, ad esempio cssproductsservice.listcssproducts.

version

string

Solo output. La versione dell'API a cui appartiene il metodo.

subapi

string

Solo output. L'API secondaria a cui appartiene il metodo. Nell'API CSS, questo valore è sempre css.

path

string

Solo output. Il percorso del metodo, ad esempio v1/cssproductsservice.listcssproducts.

ProductDetail

I dettagli del prodotto.

Campi
section_name

string

L'intestazione della sezione 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 accettabili sono: * "in" * "cm"

ProductWeight

Il peso del prodotto.

Campi
value

double

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

unit

string

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

QuotaGroup

Le informazioni sul gruppo per i metodi nell'API CSS. La quota è condivisa tra tutti i metodi del gruppo. Anche se nessuno dei metodi all'interno del gruppo è stato utilizzato, vengono restituite le informazioni per il gruppo.

Campi
name

string

Identificatore. Il nome della risorsa del gruppo di quote. Formato: accounts/{account}/quotas/{group} Esempio: accounts/12345678/quotas/css-products-insert Nota: non è garantito che la parte {group} segua un pattern specifico.

quota_usage

int64

Solo output. L'utilizzo attuale della quota, ovvero il numero di chiamate già effettuate in un determinato giorno ai metodi del gruppo. I limiti delle quote giornaliere vengono reimpostati alle ore 12:00 UTC.

quota_limit

int64

Solo output. Il numero massimo di chiamate consentite al giorno per il gruppo.

quota_minute_limit

int64

Solo output. Il numero massimo di chiamate consentite al minuto per il gruppo.

method_details[]

MethodDetails

Solo output. Elenco di tutti i metodi a cui si applica la quota del gruppo.

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

UpdateAccountLabelRequest

Messaggio di richiesta per il metodo UpdateAccountLabel.

Campi
account_label

AccountLabel

Obbligatorio. L'etichetta aggiornata. Tutti i campi devono essere compilati.

UpdateAccountLabelsRequest

Il messaggio di richiesta per il metodo UpdateLabels.

Campi
name

string

Obbligatorio. Il nome della risorsa dell'etichetta. Formato: accounts/{account}

label_ids[]

int64

L'elenco degli ID etichetta per sovrascrivere gli ID etichetta dell'account esistenti. Se l'elenco è vuoto, tutti gli ID etichetta attualmente assegnati verranno eliminati.

parent

string

Facoltativo. Obbligatorio solo durante l'aggiornamento delle etichette dell'account Merchant Center. Il dominio CSS che è la risorsa padre dell'account MC. Formato: accounts/{account}

UpdateCssProductInputRequest

Messaggio di richiesta per il metodo UpdateCssProductInput.

Campi
css_product_input

CssProductInput

Obbligatorio. La risorsa di input del prodotto CSS da aggiornare. Le informazioni inviate verranno applicate anche al prodotto CSS elaborato.

update_mask

FieldMask

L'elenco degli attributi del prodotto CSS da aggiornare.

Se la maschera di aggiornamento viene omessa, viene trattata come maschera di campo implicita equivalente a tutti i campi compilati (con un valore non vuoto).

Gli attributi specificati nella maschera di aggiornamento senza un valore specificato nel corpo verranno eliminati dal prodotto CSS.

La maschera di aggiornamento può essere specificata solo per i campi di primo livello negli attributi e negli attributi personalizzati.

Per specificare la maschera di aggiornamento per gli attributi personalizzati, devi aggiungere il prefisso custom_attribute..

Non è supportata la fornitura del valore speciale "*" per la sostituzione completa del prodotto CSS.