Package google.shopping.css.v1

Índice

AccountLabelsService

Gerencia rótulos de contas do Merchant Center e do CSS.

CreateAccountLabel

rpc CreateAccountLabel(CreateAccountLabelRequest) returns (AccountLabel)

Cria um novo marcador, não atribuído a nenhuma conta.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

DeleteAccountLabel

rpc DeleteAccountLabel(DeleteAccountLabelRequest) returns (Empty)

Exclui um rótulo e o remove de todas as contas a que ele foi atribuído.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

ListAccountLabels

rpc ListAccountLabels(ListAccountLabelsRequest) returns (ListAccountLabelsResponse)

Lista os rótulos de uma conta.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

UpdateAccountLabel

rpc UpdateAccountLabel(UpdateAccountLabelRequest) returns (AccountLabel)

Atualiza um rótulo.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

AccountsService

Serviço para gerenciar informações da conta do CSS/MC.

GetAccount

rpc GetAccount(GetAccountRequest) returns (Account)

Recupera uma única conta do CSS/MC por ID.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

ListChildAccounts

rpc ListChildAccounts(ListChildAccountsRequest) returns (ListChildAccountsResponse)

Lista todas as contas no ID da conta do CSS especificado e, opcionalmente, filtra por ID do rótulo e nome da conta.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

UpdateLabels

rpc UpdateLabels(UpdateAccountLabelsRequest) returns (Account)

Atualiza os rótulos atribuídos às contas do CSS/MC por um domínio do CSS.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

CssProductInputsService

Serviço para usar o recurso CssProductInput. Esse serviço ajuda a inserir, atualizar e excluir produtos do CSS.

DeleteCssProductInput

rpc DeleteCssProductInput(DeleteCssProductInputRequest) returns (Empty)

Exclui uma entrada de produto do CSS da sua conta do CSS Center.

Depois de uma exclusão, pode levar vários minutos até que a entrada não esteja mais disponível.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

InsertCssProductInput

rpc InsertCssProductInput(InsertCssProductInputRequest) returns (CssProductInput)

Faz upload de um CssProductInput para sua conta do CSS Center. Se já existir uma entrada com o mesmo "contentLanguage", "identity", "feedLabel" e "feedId", esse método vai substituir essa entrada.

Depois de inserir, atualizar ou excluir uma entrada de produto do CSS, pode levar vários minutos até que o produto do CSS processado possa ser recuperado.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

UpdateCssProductInput

rpc UpdateCssProductInput(UpdateCssProductInputRequest) returns (CssProductInput)

Atualiza a entrada de produto do CSS na sua conta do CSS Center.

Depois de inserir, atualizar ou excluir uma entrada de produto do CSS, pode levar vários minutos até que o produto do CSS processado possa ser recuperado.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

CssProductsService

Serviço para fazer "get" e "list" em produtos do CSS(também conhecidos como "ofertas agregadas" internamente).

GetCssProduct

rpc GetCssProduct(GetCssProductRequest) returns (CssProduct)

Recupera o produto do CSS processado da sua conta do CSS Center. Depois de inserir, atualizar ou excluir uma entrada de produto, pode levar vários minutos até que o produto final atualizado possa ser recuperado.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

ListCssProducts

rpc ListCssProducts(ListCssProductsRequest) returns (ListCssProductsResponse)

Lista os produtos do CSS processados na sua conta do CSS Center. A resposta pode conter menos itens do que o especificado por "pageSize". Use pageToken para determinar se há mais itens a serem solicitados.

Depois de inserir, atualizar ou excluir uma entrada de produto do CSS, pode levar vários minutos até que o produto atualizado seja recuperado.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

QuotaService

Serviço para receber informações de cota de chamada de método por método da API CSS.

ListQuotaGroups

rpc ListQuotaGroups(ListQuotaGroupsRequest) returns (ListQuotaGroupsResponse)

Lista a cota e o uso diários de chamadas por grupo na sua conta do CSS Center.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte OAuth 2.0 Overview.

Conta

Informações sobre a conta do CSS/MC.

Campos
name

string

O nome do recurso do rótulo. Formato: accounts/{account}

full_name

string

Apenas saída. Imutável. O nome completo da conta do CSS/MC.

label_ids[]

int64

IDs de rótulo criados manualmente e atribuídos à conta do CSS/MC por uma conta principal do CSS.

automatic_label_ids[]

int64

IDs de rótulo criados automaticamente e atribuídos à conta do MC pelo CSS Center.

account_type

AccountType

Apenas saída. O tipo desta conta.

display_name

string

O nome de exibição abreviado da conta do CSS/MC.

homepage_uri

string

Apenas saída. Imutável. A página inicial da conta do CSS/MC.

parent

string

O recurso pai da conta do CSS/MC. Grupo do CSS para domínios do CSS; domínio do CSS para contas de múltiplos clientes. Retornado apenas se o usuário tiver acesso à conta principal. Observação: para subcontas da MC, esse também é o domínio do CSS que é o recurso principal da conta da MCA, já que estamos efetivamente simplificando a hierarquia."

AccountType

O tipo de conta.

Tipos enumerados
ACCOUNT_TYPE_UNSPECIFIED Tipo de conta desconhecido.
CSS_GROUP Conta do grupo do CSS.
CSS_DOMAIN Conta de domínio do CSS.
MC_PRIMARY_CSS_MCA Conta principal da MCA do CSS do MC.
MC_CSS_MCA Conta da MCA do CSS do MC.
MC_MARKETPLACE_MCA Conta MCA de Marketplace do MC.
MC_OTHER_MCA MC Other MCA account.
MC_STANDALONE Conta independente do MC.
MC_MCA_SUBACCOUNT Subconta da MCA do MC.

AccountLabel

Rótulo atribuído por um domínio ou grupo do CSS a uma das subcontas.

Campos
name

string

Identificador. O nome do recurso do rótulo. Formato: accounts/{account}/labels/{label}

label_id

int64

Apenas saída. O ID do rótulo.

account_id

int64

Apenas saída. O ID da conta a que essa etiqueta pertence.

label_type

LabelType

Apenas saída. O tipo deste rótulo.

display_name

string

O nome de exibição desse rótulo.

description

string

A descrição do rótulo.

LabelType

O tipo de marcador.

Tipos enumerados
LABEL_TYPE_UNSPECIFIED Tipo de marcador desconhecido.
MANUAL Indica que o rótulo foi criado manualmente.
AUTOMATIC Indica que o rótulo foi criado automaticamente pelo CSS Center.

Atributos

Atributos para produtos do CSS.

Campos
low_price

Price

Preço mínimo do produto do CSS.

high_price

Price

Preço alto do produto do CSS.

headline_offer_price

Price

Preço do item principal do produto do CSS.

headline_offer_shipping_price

Price

Preço do item principal do produto do CSS.

product_types[]

string

Categorias do item (formatadas como na especificação de dados de produtos).

size_types[]

string

O corte do item. Ele pode ser usado para representar tipos de tamanhos combinados para itens de vestuário. É possível informar no máximo dois tipos de tamanho (consulte tipo de tamanho).

product_details[]

ProductDetail

Especificações técnicas ou outros detalhes do produto.

product_weight

ProductWeight

O peso do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 2.000 (inclusivo).

product_length

ProductDimension

O comprimento do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 3.000 (inclusivo).

product_width

ProductDimension

A largura do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 3.000 (inclusivo).

product_height

ProductDimension

A altura do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 3.000 (inclusivo).

product_highlights[]

string

Tópicos que descrevem os destaques mais relevantes de um produto.

certifications[]

Certification

Uma lista de certificados reivindicados pelo CSS para o produto especificado.

expiration_date

Timestamp

Data em que o item deve expirar, conforme especificado no momento da inserção, no formato ISO 8601. A data de validade real é exposta em productstatuses como googleExpirationDate e pode ser anterior se expirationDate estiver muito distante no futuro. Observação: pode levar mais de dois dias a partir da data de validade para que o item seja excluído.

included_destinations[]

string

A lista de destinos que serão incluídos nesta segmentação (corresponde às caixas de seleção marcadas no Merchant Center). Os destinos padrão são sempre incluídos, a menos que sejam fornecidos em excludedDestinations.

excluded_destinations[]

string

A lista de destinos a serem excluídos dessa segmentação (corresponde às caixas de seleção desmarcadas no Merchant Center).

headline_offer_installment

HeadlineOfferInstallment

Número e valor das parcelas a serem pagas por um item.

headline_offer_subscription_cost

HeadlineOfferSubscriptionCost

Número de períodos (meses ou anos) e valor do pagamento por período de um item com um contrato de assinatura associado.

cpp_ads_redirect

string

Permite que os anunciantes substituam o URL do item quando o produto é mostrado no contexto dos anúncios de produtos.

number_of_offers

int64

O número de produtos do CSS.

headline_offer_condition

string

Condição do item principal.

title

string

Título do item.

description

string

Descrição do item.

brand

string

Atributos relacionados ao produto.[14-36] Marca do item.

mpn

string

Número de peça do fabricante (MPN) do item.

gtin

string

Número global do item comercial (GTIN) do item.

google_product_category

string

A categoria do item no Google (consulte a taxonomia de produtos do Google). Ao consultar produtos, esse campo vai conter o valor fornecido pelo usuário. No momento, não há como recuperar as categorias de produtos do Google atribuídas automaticamente pela API.

adult

bool

Definido como "true" se o item for voltado a adultos.

multipack

int64

O número de produtos idênticos em um multipack definido pelo comerciante.

is_bundle

bool

Se o item é um pacote definido pelo comerciante. Um pacote é um agrupamento personalizado de diferentes produtos vendidos por um comerciante por um preço único.

age_group

string

Faixa etária do público-alvo do item.

color

string

Cor do item.

gender

string

Gênero a que o item é voltado.

material

string

O material de que o item é feito.

pattern

string

A estampa do item (por exemplo, bolinhas).

size

string

Tamanho do item. Apenas um valor é permitido. Para variantes com tamanhos diferentes, insira um produto separado para cada tamanho com o mesmo valor de itemGroupId (consulte [https://support.google.com/merchants/answer/6324492](definição de tamanho)).

size_system

string

Sistema em que o tamanho é especificado. Recomendado para itens de vestuário.

item_group_id

string

Identificador compartilhado por todas as variantes do mesmo produto.

pause

string

A publicação deste item será pausada temporariamente.

custom_label_0

string

Rótulo personalizado 0 para agrupamento personalizado de itens em uma campanha do Shopping.

custom_label_1

string

Rótulo personalizado 1 para agrupamento personalizado de itens em uma campanha do Shopping.

custom_label_2

string

Rótulo personalizado 2 para agrupamento personalizado de itens em uma campanha do Shopping.

custom_label_3

string

Rótulo personalizado 3 para agrupamento personalizado de itens em uma campanha do Shopping.

custom_label_4

string

Rótulo personalizado 4 para agrupamento personalizado de itens em uma campanha do Shopping.

review_count

int64

Número de avaliações do produto. Obrigatório se rating for fornecido. Este campo é para um recurso futuro e ainda não é usado.

min_rating

int64

Pontuação mínima da avaliação do produto. Obrigatório se rating for fornecido. Este campo é para um recurso futuro e ainda não é usado.

max_rating

int64

Pontuação máxima da avaliação do produto. Obrigatório se rating for fornecido. Este campo é para um recurso futuro e ainda não é usado.

rating

double

É a pontuação média da classificação do produto. O valor precisa estar no intervalo [min_rating, max_rating], inclusive. Quando mostrada na página do produto, essa classificação é normalizada para uma escala de [1, 5] com uma casa decimal. Se fornecidos, review_count, min_rating e max_rating também são obrigatórios. Este campo é para um recurso futuro e ainda não é usado.

Certificação

A certificação do produto. Use esse atributo para descrever certificações associadas a um produto, como classificações de eficiência energética.

Campos
name

string

É o nome da certificação. No momento, o valor mais comum é "EPREL", que representa as certificações de eficiência energética no banco de dados do Registro Europeu de Produtos para a Etiquetagem Energética (EPREL) da UE.

authority

string

O órgão ou a autoridade responsável pela emissão da certificação. No momento, o valor mais comum é "EC" ou "European_Commission" para selos de eficiência energética na UE.

code

string

É o código da certificação. Por exemplo, para o certificado EPREL com o link https://eprel.ec.europa.eu/screen/product/dishwashers2019/123456, o código é 123456. Ele é necessário para os selos de eficiência energética europeus.

CreateAccountLabelRequest

Mensagem de solicitação para o método "CreateAccountLanel".

Campos
parent

string

Obrigatório. A conta principal. Formato: accounts/{account}

account_label

AccountLabel

Obrigatório. O marcador a ser criado.

CssProduct

O produto do CSS processado.

Campos
name

string

O nome do produto do CSS. Formato: "accounts/{account}/cssProducts/{css_product}"

raw_provided_id

string

Apenas saída. Seu identificador bruto exclusivo do produto.

content_language

string

Apenas saída. O código de idioma ISO 639-1 de duas letras do produto.

feed_label

string

Apenas saída. O rótulo do feed do produto.

attributes

Attributes

Apenas saída. Uma lista de atributos do produto.

custom_attributes[]

CustomAttribute

Apenas saída. Uma lista de atributos personalizados (fornecidos por CSS). Também é possível usar para enviar qualquer atributo da especificação do feed na forma genérica (por exemplo, { "name": "size type", "value": "regular" }). Isso é útil para enviar atributos não expostos explicitamente pela API, como atributos adicionais usados para o Comprar com o Google.

css_product_status

CssProductStatus

Apenas saída. O status de um produto, problemas de validação de dados, ou seja, informações sobre um produto calculadas de forma assíncrona.

CssProductInput

Esse recurso representa os dados de entrada enviados para um produto do CSS, não o produto do CSS processado que você vê no CSS Center, nos anúncios do Shopping ou no Google plataformas.

Campos
name

string

Identificador. O nome da entrada de produto do CSS. Formato: accounts/{account}/cssProductInputs/{css_product_input}, em que a última seção css_product_input consiste em três partes: contentLanguage~feedLabel~offerId. Exemplo: accounts/123/cssProductInputs/de~DE~rawProvidedId123

final_name

string

Apenas saída. O nome do produto do CSS processado. Formato: accounts/{account}/cssProducts/{css_product} "

raw_provided_id

string

Obrigatório. Seu identificador exclusivo para o produto do CSS. O mesmo vale para a entrada e o produto do CSS processado. Só permitimos IDs com caracteres alfanuméricos, sublinhados e traços. Consulte a especificação do feed de produtos para mais detalhes.

content_language

string

Obrigatório. O código de idioma ISO 639-1 de duas letras do produto do CSS.

feed_label

string

Obrigatório. O rótulo do feed do produto do CSS. O rótulo do feed é sinônimo de "país de destino" e, portanto, sempre precisa ser um código de região válido. Por exemplo, "DE" para Alemanha e "FR" para França.

freshness_time
(deprecated)

Timestamp

OBSOLETO. Use expiration_date. Representa a versão atual (atualidade) do produto do CSS, que pode ser usada para preservar a ordem correta quando várias atualizações são feitas ao mesmo tempo.

Este campo não pode ser definido para uma data futura.

Se definido, a atualização será impedida se uma versão mais recente do item já existir no nosso sistema. Ou seja, se o último horário de atualização dos produtos do CSS for posterior ao tempo de atualização definido. Se a atualização acontecer, o horário da última atualização será definido como esse horário de atualização.

Se não for definido, a atualização não será impedida, e o horário da última atualização será o padrão de quando esta solicitação foi recebida pela API CSS.

Se a operação for impedida, a exceção de interrupção será gerada.

attributes

Attributes

Uma lista de atributos de produtos do CSS.

custom_attributes[]

CustomAttribute

Uma lista de atributos personalizados (fornecidos por CSS). Ele também pode ser usado para enviar qualquer atributo da especificação do feed na forma genérica (por exemplo, { "name": "size type", "value": "regular" }). Isso é útil para enviar atributos não expostos explicitamente pela API, como atributos adicionais usados para o Comprar com o Google.

CssProductStatus

O status do produto do CSS, problemas de validação de dados, ou seja, informações sobre o produto do CSS calculadas de forma assíncrona.

Campos
destination_statuses[]

DestinationStatus

Os destinos pretendidos do produto.

item_level_issues[]

ItemLevelIssue

Uma lista de todos os problemas associados ao produto.

creation_date

Timestamp

Data em que o item foi criado, no formato ISO 8601.

last_update_date

Timestamp

Data em que o item foi atualizado pela última vez, no formato ISO 8601.

google_expiration_date

Timestamp

Data em que o item expira, no formato ISO 8601.

DestinationStatus

O status de destino do status do produto.

Campos
destination

string

O nome do destino

approved_countries[]

string

Lista de códigos de países (ISO 3166-1 alpha-2) em que o produto do CSS foi aprovado.

pending_countries[]

string

Lista de códigos de países (ISO 3166-1 alpha-2) em que o produto do CSS está aguardando aprovação.

disapproved_countries[]

string

Lista de códigos de países (ISO 3166-1 alpha-2) em que o produto do CSS foi reprovado.

ItemLevelIssue

O ItemLevelIssue do status do produto.

Campos
code

string

O código de erro do problema.

servability

string

Como esse problema afeta a veiculação do produto do CSS.

resolution

string

Se o problema pode ser resolvido pelo comerciante.

attribute

string

O nome do atributo, se o problema for causado por um único atributo

destination

string

O destino a que o problema se aplica.

description

string

Uma breve descrição do problema em inglês.

detail

string

Uma descrição detalhada do problema em inglês.

documentation

string

O URL de uma página da web para ajudar a resolver esse problema.

applicable_countries[]

string

Lista de códigos de países (ISO 3166-1 alfa-2) em que o problema se aplica ao produto do CSS.

DeleteAccountLabelRequest

Mensagem de solicitação para o método "DeleteAccountLabel".

Campos
name

string

Obrigatório. O nome do rótulo a ser excluído. Formato: accounts/{account}/labels/{label}

DeleteCssProductInputRequest

Mensagem de solicitação para o método DeleteCssProductInput.

Campos
name

string

Obrigatório. O nome do recurso de entrada do produto do CSS a ser excluído. Formato: accounts/{account}/cssProductInputs/{css_product_input}, em que a última seção css_product_input consiste em três partes: contentLanguage~feedLabel~offerId. Exemplo: accounts/123/cssProductInputs/de~DE~rawProvidedId123

supplemental_feed_id

int64

O ID do feed complementar da API Content. O campo não pode ser definido se a ação se aplicar a um feed principal. Se o campo estiver definido, a ação do produto será aplicada a um feed complementar em vez do feed principal da API Content.

GetAccountRequest

A mensagem de solicitação para o método GetAccount.

Campos
name

string

Obrigatório. O nome da conta gerenciada do CSS/MC. Formato: accounts/{account}

parent

string

Opcional. Obrigatório apenas ao recuperar informações da conta do MC. O domínio do CSS que é o recurso pai da conta do MC. Formato: accounts/{account}

GetCssProductRequest

A mensagem de solicitação para o método GetCssProduct.

Campos
name

string

Obrigatório. O nome do produto do CSS a ser recuperado. Formato: accounts/{account}/cssProducts/{css_product}

HeadlineOfferInstallment

Uma mensagem que representa uma parcela.

Campos
months

int64

O número de parcelas que o comprador precisa pagar.

amount

Price

O valor que o comprador precisa pagar por mês.

downpayment

Price

O valor da entrada inicial que o comprador precisa pagar.

HeadlineOfferSubscriptionCost

O SubscriptionCost do produto.

Campos
period

SubscriptionPeriod

O tipo de período de assinatura. Os valores aceitos são: * "month" * "year"

period_length

int64

O número de períodos de assinatura que o comprador precisa pagar.

amount

Price

O valor que o comprador precisa pagar por período de assinatura.

InsertCssProductInputRequest

Mensagem de solicitação para o método "InsertCssProductInput".

Campos
parent

string

Obrigatório. A conta em que este produto do CSS será inserido. Formato: accounts/{account}

css_product_input

CssProductInput

Obrigatório. A entrada de produto do CSS a ser inserida.

feed_id
(deprecated)

int64

Opcional. OBSOLETO. O ID do feed não é obrigatório para produtos do CSS. O ID do feed principal ou complementar. Se o produto do CSS já existir e o ID do feed fornecido for diferente, o produto do CSS será movido para um novo feed. Observação: por enquanto, os CSSs não precisam fornecer IDs de feed porque criamos feeds na hora. Ainda não temos suporte para feeds complementares de produtos do CSS.

ListAccountLabelsRequest

Solicite mensagem para o método ListAccountLabels.

Campos
parent

string

Obrigatório. A conta principal. Formato: accounts/{account}

page_size

int32

O número máximo de rótulos a serem retornados. O serviço pode retornar um valor inferior a este. Se não for especificado, no máximo 50 rótulos serão retornados. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000.

page_token

string

Um token de página recebido de uma chamada ListAccountLabels anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para ListAccountLabels precisam corresponder à chamada que forneceu o token da página.

ListAccountLabelsResponse

Mensagem de resposta para o método ListAccountLabels.

Campos
account_labels[]

AccountLabel

Os rótulos da conta especificada.

next_page_token

string

Um token, que pode ser enviado como page_token para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

ListChildAccountsRequest

A mensagem de solicitação para o método ListChildAccounts.

Campos
parent

string

Obrigatório. A conta principal. Precisa ser um grupo do CSS ou domínio. Formato: accounts/{account}

page_size

int32

Opcional. O número máximo de contas a serem retornadas. O serviço pode retornar um valor inferior a este. Se não for especificado, no máximo 50 contas serão retornadas. O valor máximo é 100. Valores acima disso vão ser convertidos para 100.

page_token

string

Opcional. Um token de página recebido de uma chamada ListChildAccounts anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para ListChildAccounts precisam corresponder à chamada que forneceu o token da página.

label_id

int64

Se definido, somente as contas da MC com o ID de rótulo especificado serão retornadas.

full_name

string

Se definido, somente as contas da MC com o nome especificado (diferenciação de maiúsculas e minúsculas) serão retornadas.

ListChildAccountsResponse

Mensagem de resposta para o método ListChildAccounts.

Campos
accounts[]

Account

As contas do CSS/MC retornadas para a conta principal do CSS especificada.

next_page_token

string

Um token, que pode ser enviado como page_token para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

ListCssProductsRequest

Mensagem de solicitação para o método "ListCssProducts".

Campos
parent

string

Obrigatório. A conta/domínio para listar os produtos do CSS processados. Formato: accounts/{account}

page_size

int32

O número máximo de produtos do CSS a serem retornados. O serviço pode retornar um valor inferior a este. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000. Se não for especificado, o número máximo de produtos do CSS será retornado.

page_token

string

Um token de página recebido de uma chamada ListCssProducts anterior. Forneça isso para recuperar a página subsequente.

Ao paginar, todos os outros parâmetros fornecidos para ListCssProducts precisam corresponder à chamada que forneceu o token da página.

ListCssProductsResponse

Mensagem de resposta para o método "ListCssProducts".

Campos
css_products[]

CssProduct

Os produtos do CSS processados da conta especificada. São os produtos do CSS processados depois da aplicação de regras e feeds complementares.

next_page_token

string

Um token, que pode ser enviado como page_token para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

ListQuotaGroupsRequest

Mensagem de solicitação para o método "ListQuotaGroups".

Campos
parent

string

Obrigatório. A conta do CSS proprietária da coleção de cotas de método e recursos. Na maioria dos casos, esse é o domínio do CSS. Formato: accounts/{account}

page_size

int32

Opcional. O número máximo de cotas a serem retornadas na resposta, usado para paginação. O padrão é 500. Valores acima de 1.000 serão convertidos para 1.000.

page_token

string

Opcional. Token (se fornecido) para recuperar a página seguinte. Todos os outros parâmetros precisam corresponder à chamada original que forneceu o token da página.

ListQuotaGroupsResponse

Mensagem de resposta para o método ListMethodGroups.

Campos
quota_groups[]

QuotaGroup

Os métodos, o uso atual da cota e os limites de cada grupo. A cota é compartilhada entre todos os métodos do grupo. Os grupos são classificados em ordem decrescente com base em quota_usage.

next_page_token

string

Um token, que pode ser enviado como page_token para recuperar a próxima página. Se esse campo for omitido, não haverá páginas subsequentes.

MethodDetails

Os detalhes de cada método na API CSS.

Campos
method

string

Apenas saída. O nome do método, por exemplo, cssproductsservice.listcssproducts.

version

string

Apenas saída. A versão da API a que o método pertence.

subapi

string

Apenas saída. A sub-API a que o método pertence. Na API CSS, esse valor é sempre css.

path

string

Apenas saída. O caminho do método, como v1/cssproductsservice.listcssproducts.

ProductDetail

Os detalhes do produto.

Campos
section_name

string

O cabeçalho da seção usado para agrupar um conjunto de detalhes do produto.

attribute_name

string

O nome do detalhe do produto.

attribute_value

string

O valor do detalhe do produto.

ProductDimension

A dimensão do produto.

Campos
value

double

Obrigatório. O valor da dimensão representado como um número. O valor pode ter uma precisão máxima de quatro casas decimais.

unit

string

Obrigatório. As unidades de dimensão. Os valores aceitáveis são: * "in" * "cm"

ProductWeight

O peso do produto.

Campos
value

double

Obrigatório. O peso representado como um número. O peso pode ter uma precisão máxima de quatro casas decimais.

unit

string

Obrigatório. A unidade de peso. Os valores aceitáveis são: * "g" * "kg" * "oz" * "lb"

QuotaGroup

As informações do grupo para métodos na API CSS. A cota é compartilhada entre todos os métodos do grupo. Mesmo que nenhum dos métodos no grupo tenha uso, as informações do grupo serão retornadas.

Campos
name

string

Identificador. O nome do recurso do grupo de cota. Formato: accounts/{account}/quotas/{group} Exemplo: accounts/12345678/quotas/css-products-insert Observação: não há garantia de que a parte {group} siga um padrão específico.

quota_usage

int64

Apenas saída. O uso atual da cota, ou seja, o número de chamadas já feitas em um determinado dia para os métodos do grupo. Os limites de cota diária são redefinidos às 12h UTC.

quota_limit

int64

Apenas saída. O número máximo de chamadas permitidas por dia para o grupo.

quota_minute_limit

int64

Apenas saída. O número máximo de chamadas permitidas por minuto para o grupo.

method_details[]

MethodDetails

Apenas saída. Lista de todos os métodos a que a cota de grupo se aplica.

SubscriptionPeriod

O período de assinatura do produto.

Tipos enumerados
SUBSCRIPTION_PERIOD_UNSPECIFIED Indica que o período da assinatura não foi especificado.
MONTH Indica que o período de assinatura é mensal.
YEAR Indica que o período da assinatura é anual.

UpdateAccountLabelRequest

Solicite mensagem para o método UpdateAccountLabel.

Campos
account_label

AccountLabel

Obrigatório. O rótulo atualizado. Todos os campos precisam ser preenchidos.

UpdateAccountLabelsRequest

A mensagem de solicitação para o método UpdateLabels.

Campos
name

string

Obrigatório. O nome do recurso do rótulo. Formato: accounts/{account}

label_ids[]

int64

A lista de IDs de rótulo para substituir os IDs de rótulo da conta atual. Se a lista estiver vazia, todos os IDs de rótulo atribuídos no momento serão excluídos.

parent

string

Opcional. Necessário apenas ao atualizar os rótulos da conta da MC. O domínio do CSS que é o recurso pai da conta do MC. Formato: accounts/{account}

UpdateCssProductInputRequest

Mensagem de solicitação para o método UpdateCssProductInput.

Campos
css_product_input

CssProductInput

Obrigatório. O recurso de entrada de produto do CSS a ser atualizado. As informações enviadas também serão aplicadas ao produto do CSS processado.

update_mask

FieldMask

A lista de atributos de produtos do CSS a serem atualizados.

Se a máscara de atualização for omitida, ela será tratada como uma máscara de campo implícita equivalente a todos os campos preenchidos (com um valor não vazio).

Os atributos especificados na máscara de atualização sem um valor especificado no corpo serão excluídos do produto CSS.

A máscara de atualização só pode ser especificada para campos de nível superior em atributos e atributos personalizados.

Para especificar a máscara de atualização de atributos personalizados, adicione o prefixo custom_attribute..

Não é possível fornecer o valor especial "*" para substituição completa de produtos do CSS.