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 ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

DeleteAccountLabel

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

Consente di eliminare un'etichetta e di rimuoverla da tutti gli account a cui è stata assegnata.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione 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 ulteriori informazioni, consulta la sezione 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 ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

AccountsService

Servizio per la gestione dei dati dell'account CSS/MC.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Recupera un singolo account CSS/MC tramite ID.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

ListChildAccounts

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

Elenca tutti gli account associati all'ID account CSS specificato e, facoltativamente, li filtra in base all'ID etichetta e al nome dell'account.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione 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 ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

CssProductInputsService

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

DeleteCssProductInput

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

Consente di eliminare un input del prodotto CSS dal tuo account CSS Center.

Dopo un'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 ulteriori informazioni, consulta la sezione 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 contentLanguage, identity, feedLabel e feedId, questo metodo sostituisce la voce.

Dopo aver inserito, aggiornato o eliminato un input del prodotto CSS, potrebbero essere necessari diversi minuti prima che il prodotto CSS elaborato possa essere recuperato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

UpdateCssProductInput

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

Aggiorna l'input del prodotto CSS esistente nel tuo account CSS Center.

Dopo aver inserito, aggiornato o eliminato un input del prodotto CSS, potrebbero essere necessari diversi minuti prima che il prodotto CSS elaborato possa essere recuperato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

CssProductsService

Servizio per eseguire get ed elencare i prodotti CSS(ovvero le 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 del prodotto, potrebbero essere necessari diversi minuti prima che il prodotto finale aggiornato possa essere recuperato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione 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 rispetto a quanto specificato da pageSize. Utilizza pageToken per determinare se ci sono altri elementi da richiedere.

Dopo aver inserito, aggiornato o eliminato un input del prodotto CSS, potrebbero essere necessari diversi minuti prima che il prodotto CSS elaborato aggiornato possa essere recuperato.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

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

Per ulteriori informazioni, consulta la sezione OAuth 2.0 Overview.

QuotaService

Servizio per ottenere informazioni sulle quote di chiamata dei metodi per metodo dell'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 ulteriori informazioni, consulta la sezione 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 e 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 principale dell'account CSS/MC. Gruppo di CSS per i domini CSS; dominio CSS per gli account MC. Viene restituito solo se l'utente ha accesso all'account principale. Nota: per i subaccount MC, si tratta anche del dominio CSS che è la risorsa principale dell'account AMC, poiché stiamo effettivamente appiattando 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 del commerciante.
MC_CSS_MCA Account AMC CSS MC.
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 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 dell'offerta principale del prodotto CSS.

headline_offer_shipping_price

Price

Prezzo dell'offerta 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 [https://support.google.com/merchants/answer/6324497](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

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

certifications[]

Certification

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

expiration_date

Timestamp

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.

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 alle 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 articolo con un contratto di abbonamento associato.

cpp_ads_redirect

string

Consente agli inserzionisti di sostituire l'URL dell'articolo quando il prodotto viene mostrato nel contesto degli annunci 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 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 è rivolto a un pubblico adulto.

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 diversi prodotti venduti da un commerciante a un unico prezzo.

age_group

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

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 articolo verrà temporaneamente sospesa.

custom_label_0

string

Etichetta personalizzata 0 per il raggruppamento personalizzato degli elementi 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 elementi in una campagna Shopping.

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

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

feed_label

string

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

attributes

Attributes

Solo output. Un elenco di attributi del 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 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.

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 per il prodotto CSS elaborato. Sono consentiti solo ID con caratteri alfanumerici, trattini bassi e trattini. Per maggiori dettagli, consulta la specifica del feed dei prodotti.

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 sull'ora futura.

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

Se non viene impostato, l'aggiornamento non verrà impedito e l'ora dell'ultimo aggiornamento sarà quella in cui questa richiesta è stata ricevuta dall'API CSS.

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

attributes

Attributes

Un elenco di attributi del prodotto 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 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

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

Data di creazione dell'elemento, nel formato ISO 8601.

last_update_date

Timestamp

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

google_expiration_date

Timestamp

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

DestinationStatus

Lo stato di 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 non è approvato.

ItemLevelIssue

Il problema a livello di articolo 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 che possa aiutarci a risolvere il problema.

applicable_countries[]

string

Elenco dei codici paese (ISO 3166-1 alpha-2) in cui il problema si applica al 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 dei prodotti 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 del feed supplementare dell'API Content. Il campo non deve essere impostato se l'azione si applica a un feed principale. Se il campo è impostato, l'azione di prodotto si applica a un feed supplementare anziché al feed principale dell'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 dei dati dell'account MC. Il dominio CSS che è la risorsa principale 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.

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

HeadlineOfferSubscriptionCost

Il valore SubscriptionCost del 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 ogni 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 gli ID feed perché li creiamo al volo. Non è ancora disponibile il supporto dei 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 meno di 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 chiamata ListAccountLabels precedente. Fornisci questo valore per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListAccountLabels devono corrispondere alla chiamata che ha fornito il token 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 o un dominio CSS. Formato: accounts/{account}

page_size

int32

Facoltativo. Il numero massimo di account da restituire. Il servizio potrebbe restituire meno di 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 chiamata ListChildAccounts precedente. Fornisci questo valore per recuperare la pagina successiva.

Quando viene applicata la paginazione, tutti gli altri parametri forniti a ListChildAccounts devono corrispondere alla chiamata che ha fornito il token 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/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 meno di 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 chiamata ListCssProducts precedente. Fornisci questo valore per recuperare la pagina successiva.

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

ListCssProductsResponse

Messaggio di risposta per il metodo ListCssProducts.

Campi
css_products[]

CssProduct

I prodotti CSS elaborati dell'account specificato. Si tratta dei 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 risorse e quote 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 pagina.

ListQuotaGroupsResponse

Messaggio di risposta per il metodo ListMethodGroups.

Campi
quota_groups[]

QuotaGroup

I metodi, l'utilizzo e i limiti attuali delle quote per ciascun 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 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 accettati sono: * "in" * "cm"

ProductWeight

Il peso del prodotto.

Campi
value

double

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"

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 ha un utilizzo, le informazioni relative al gruppo vengono restituite.

Campi
name

string

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

quota_usage

int64

Solo output. L'utilizzo corrente della quota, ovvero il numero di chiamate già effettuate in un determinato giorno ai metodi del gruppo. I limiti di quota giornaliera 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 è mensile.
YEAR Indica che il periodo di abbonamento è un anno.

UpdateAccountLabelRequest

Messaggio di richiesta per il metodo UpdateAccountLabel.

Campi
account_label

AccountLabel

Obbligatorio. L'etichetta aggiornata. È necessario fornire tutti i campi.

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 da sovrascrivere con gli ID etichetta dell'account esistenti. Se l'elenco è vuoto, tutti gli ID etichetta attualmente assegnati verranno eliminati.

parent

string

Facoltativo. Obbligatorio solo per aggiornare le etichette dell'account MC. Il dominio CSS che è la risorsa principale 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 (che hanno 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 è supportato il valore speciale "*" per la sostituzione completa dei prodotti CSS.