Package google.shopping.merchant.products.v1beta

Índice

ProductInputsService

Serviço para usar o recurso ProductInput. Esse serviço funciona apenas para produtos com um canal on-line.

DeleteProductInput

rpc DeleteProductInput(DeleteProductInputRequest) returns (Empty)

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

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

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.
InsertProductInput

rpc InsertProductInput(InsertProductInputRequest) returns (ProductInput)

Faz upload de uma entrada de produto na sua conta do Merchant Center. Se uma entrada com o mesmo contentLanguage, offerId e dataSource já existir, este método substituirá essa entrada.

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

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

ProductsService

Serviço para usar o recurso do produto. Esse serviço funciona apenas para produtos com um canal on-line.

GetProduct

rpc GetProduct(GetProductRequest) returns (Product)

Recupera o produto processado da sua conta do Merchant 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 a Visão geral do OAuth 2.0.
ListProducts

rpc ListProducts(ListProductsRequest) returns (ListProductsResponse)

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

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

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.

Atributos

Atributos.

Campos
expiration_date

Timestamp

É a data em que o item deve expirar, conforme especificado no momento da inserção, no formato ISO 8601. A data de validade real aparece no productstatuses como googleExpirationDate e poderá ser anterior se expirationDate estiver muito distante.
disclosure_date

Timestamp

É a data e hora em que uma oferta fica visível nos resultados da pesquisa nas plataformas do YouTube do Google, no formato ISO 8601. Consulte [Data de divulgação]( https://support.google.com/merchants/answer/13034208) para mais informações.
availability_date

Timestamp

É o dia em que um produto encomendado fica disponível para entrega, no formato ISO 8601.
price

Price

Preço do item.
installment

Installment

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

SubscriptionCost

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

LoyaltyPoints

Pontos de fidelidade que os usuários recebem após a compra do item. Somente no Japão.
loyalty_programs[]

LoyaltyProgram

Uma lista de informações do programa de fidelidade que é usada para mostrar os benefícios de fidelidade (por exemplo, melhores preços, pontos etc.) ao usuário do item.
product_types[]

string

Categorias do item (formatadas como na especificação dos dados do produto).
sale_price

Price

Preço promocional anunciado do item.
sale_price_effective_date

Interval

Período em que o item estará à venda (consulte a especificação dos dados do produto).
product_height

ProductDimension

A altura do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 3.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_weight

ProductWeight

O peso do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 2000 (inclusivo).
shipping[]

Shipping

Regras de envio.
free_shipping_threshold[]

FreeShippingThreshold

Condições a serem atendidas para que o produto tenha frete grátis.
shipping_weight

ShippingWeight

Peso do item para envio.
shipping_length

ShippingDimension

Comprimento do item para envio.
shipping_width

ShippingDimension

Largura do item para envio.
shipping_height

ShippingDimension

Altura do item para envio.
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 [https://support.google.com/merchants/answer/6324497](tipo de tamanho)).
taxes[]

Tax

Informações fiscais.
unit_pricing_measure

UnitPricingMeasure

A medida e a dimensão de um item.
unit_pricing_base_measure

UnitPricingBaseMeasure

A preferência do denominador do preço unitário.
ads_labels[]

string

Semelhante ao ads_grouping, mas funciona apenas com CPC.
cost_of_goods_sold

Price

Custo dos produtos vendidos. Usado para relatórios de lucro bruto.
product_details[]

ProductDetail

Especificação técnica ou detalhes adicionais do produto.
product_highlights[]

string

Tópicos que descrevem as características mais relevantes de um produto.
display_ads_similar_ids[]

string

Recomendações especificadas pelo anunciante.
promotion_ids[]

string

O ID exclusivo de uma promoção.
included_destinations[]

string

A lista de destinos a serem incluídos para essa meta (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).
shopping_ads_excluded_countries[]

string

Lista de códigos de país (ISO 3166-1 alfa-2) para excluir a oferta do destino dos anúncios do Shopping. Os países desta lista serão removidos daqueles definidos nas configurações da fonte de dados.
cloud_export_additional_properties[]

CloudExportAdditionalProperties

Campos extras a serem exportados para o programa Cloud Retail.
certifications[]

Certification

Certificações de produtos, por exemplo, para identificação de eficiência energética de itens registrados no banco de dados Registro Europeu de Produtos para a Etiquetagem Energética (EPREL, na sigla em inglês) da UE. Consulte o artigo da Central de Ajuda para mais informações.
auto_pricing_min_price

Price

Uma proteção nos projetos "Descontos automáticos" (https://support.google.com/merchants/answer/10295759) e "Promoções dinâmicas" (https://support.google.com/merchants/answer/13949249), garantindo que os descontos nas ofertas dos comerciantes não fiquem abaixo desse valor, preservando o valor e a lucratividade da oferta.
identifier_exists

bool

Defina esse valor como "false" quando o item não tiver identificadores exclusivos de produto adequados à categoria, como GTIN, MPN e marca. Se não for informado, o padrão será "true".
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 único preço.
title

string

Título do item.
description

string

Descrição do item.
adult

bool

Defina como "true" se o item for destinado a adultos.
age_group

string

Segmentar a idade do item.
availability

string

Status de disponibilidade do item.
brand

string

Marca do item.
color

string

Cor do item.
condition

string

Condição ou estado do item.
gender

string

Gênero-alvo do item.
google_product_category

string

Categoria Google para o item (consulte a Taxonomia do produto do Google). Ao consultar produtos, esse campo conterá o valor fornecido pelo usuário. No momento, não é possível recuperar as categorias Google dos produtos atribuídas automaticamente pela API.
gtin

string

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

string

Identificador compartilhado de todas as variantes do mesmo produto.
material

string

Material de que o item é feito.
mpn

string

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

string

Estampa do item (por exemplo, bolinhas).
sell_on_google_quantity

int64

A quantidade do produto disponível para venda no Google. Compatível apenas com produtos on-line.
max_handling_time

int64

Tempo em separação máximo do produto (em dias úteis).
min_handling_time

int64

Tempo em separação mínimo do produto (em dias úteis).
shipping_label

string

O rótulo para envio do produto, usado para agrupar o produto em regras de frete no nível da conta.
transit_time_label

string

O rótulo de tempo em trânsito do produto, usado para agrupar o produto nas tabelas de tempo em trânsito no nível da conta.
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.
tax_category

string

A categoria fiscal do produto, usada para definir o vínculo fiscal detalhado nas configurações de tributos no nível da conta.
energy_efficiency_class

string

A classe de eficiência energética, conforme definido na diretiva 2010/30/EU da UE.
min_energy_efficiency_class

string

A classe de eficiência energética, conforme definido na diretiva 2010/30/EU da UE.
max_energy_efficiency_class

string

A classe de eficiência energética, conforme definido na diretiva 2010/30/EU da UE.
multipack

int64

Número de produtos idênticos em um multipack definido pelo comerciante.
ads_grouping

string

Usados para agrupar itens de maneira arbitrária. Somente para CPA%. Caso contrário, não é recomendado.
ads_redirect

string

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

string

Identificador de um item para campanhas de remarketing dinâmico.
display_ads_title

string

Título de um item para campanhas de remarketing dinâmico.
display_ads_value

double

Margem da oferta para campanhas de remarketing dinâmico.
pickup_method

string

A opção de retirada do item.
pickup_sla

string

Cronograma de retirada do item na loja.
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.
external_seller_id

string

Obrigatório para contas de vários vendedores. Use esse atributo se você tiver um marketplace fazendo upload de produtos para vários vendedores na sua conta de vários vendedores.
pause

string

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

ProductStructuredTitle

Título estruturado para títulos gerados por algoritmos (IA).
structured_description

ProductStructuredDescription

Descrição estruturada, para descrições geradas por algoritmos (IA).

Certificação

Certificação do produto, apresentada inicialmente para conformidade com a rotulagem de eficiência energética da UE usando o banco de dados EPREL da UE.

Campos
certification_authority

string

A autoridade certificadora, por exemplo, "European_Commission". O tamanho máximo é de 2.000 caracteres.
certification_name

string

O nome da certificação, por exemplo, "EPREL". O tamanho máximo é de 2.000 caracteres.
certification_code

string

O código da certificação. O tamanho máximo é de 2.000 caracteres.
certification_value

string

O valor da certificação, também conhecido como classe, nível ou série, por exemplo, "A+", "C", "ouro". O tamanho máximo é de 2.000 caracteres.

CloudExportAdditionalProperties

Propriedade de produto da API Cloud Retail. Por exemplo, as propriedades de um produto de TV podem ser "Resolução da tela" ou "Tamanho da tela".

Campos
text_value[]

string

Valor de texto da propriedade especificada. Por exemplo, "8K(Ultra HD)" pode ser um valor de texto para um produto de TV. A repetição máxima desse valor é 400. Os valores são armazenados em uma ordem arbitrária, mas consistente. O tamanho máximo da string é de 256 caracteres.
int_value[]

int64

Valores inteiros da propriedade especificada. Por exemplo, 1080 para a resolução da tela de um produto de TV. A repetição máxima desse valor é 400. Os valores são armazenados em uma ordem arbitrária, mas consistente.
float_value[]

float

Valores flutuantes da propriedade especificada. Por exemplo, para um produto de TV 1,2345. A repetição máxima desse valor é 400. Os valores são armazenados em uma ordem arbitrária, mas consistente.
property_name

string

Nome da propriedade especificada. Por exemplo, "Resolução da tela" para um produto de TV. O tamanho máximo da string é de 256 caracteres.
bool_value

bool

Valor booleano da propriedade especificada. Por exemplo, para um produto de TV, escolha "Verdadeiro" ou "Falso" se a tela for Ultra HD.
min_value

float

Valor flutuante mínimo da propriedade especificada. Por exemplo, para um produto de TV 1,00.
max_value

float

Valor flutuante máximo da propriedade especificada. Por exemplo, para um produto de TV 100,00.
unit_code

string

Unidade da propriedade especificada. Por exemplo, "Pixels" para um produto de TV. O tamanho máximo da string é 256B.

DeleteProductInputRequest

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

Campos
name

string

Obrigatório. O nome do recurso de entrada do produto a ser excluído. Formato: accounts/{account}/productInputs/{product}
data_source

string

Obrigatório. A fonte de dados principal ou complementar da qual a entrada do produto deve ser excluída. Formato: accounts/{account}/dataSources/{datasource}.

FreeShippingThreshold

Condições a serem atendidas para que o produto tenha frete grátis.

Campos
country

string

O código de território CLDR do país para o qual um item será enviado.
price_threshold

Price

O preço mínimo do produto para que o custo de frete se torne sem custo financeiro. Representado como um número.

GetProductRequest

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

Campos
name

string

Obrigatório. O nome do produto a ser recuperado. Formato: accounts/{account}/products/{product}

InsertProductInputRequest

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

Campos
parent

string

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

ProductInput

Obrigatório. A entrada do produto a ser inserida.
data_source

string

Obrigatório. O nome da fonte de dados do produto principal ou complementar. Se o produto já existir e a fonte de dados fornecida for diferente, ele será movido para uma nova fonte. Formato: accounts/{account}/dataSources/{datasource}.

Parcelas

Uma mensagem que representa parcelas.

Campos
months

int64

O número de parcelas que o comprador deve pagar.
amount

Price

O valor que o comprador tem que pagar por mês.
downpayment

Price

O valor da entrada que o comprador precisa pagar.
credit_type

string

Tipo de parcelamento. Os valores aceitos são: * "finance" * "lease"

ListProductsRequest

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

Campos
parent

string

Obrigatório. A conta para listar os produtos processados. Formato: accounts/{account}
page_size

int32

O número máximo de produtos a serem retornados. O serviço pode retornar menos que esse valor. O valor máximo é 1.000. Valores maiores serão convertidos para 1.000. Se não for especificado, será retornado o número máximo de produtos.
page_token

string

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

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

ListProductsResponse

Mensagem de resposta para o método ListProducts.

Campos
products[]

Product

Os produtos processados da conta especificada. Esses são seus produtos processados após a aplicação de regras e fontes de dados 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.

LoyaltyPoints

Uma mensagem que representa os pontos de fidelidade.

Campos
name

string

Nome do programa de de fidelidade. Recomenda-se limitar o nome a 12 caracteres de largura total ou 24 caracteres romanos.
points_value

int64

Os pontos de fidelidade do varejista em valor absoluto.
ratio

double

A proporção de um ponto ao ser convertido em moeda. O Google pressupõe a moeda com base nas configurações do Merchant Center. Se a proporção não for informada, o padrão será 1.0.

LoyaltyProgram

Uma mensagem que representa o programa de fidelidade.

Campos
program_label

string

O rótulo do programa de fidelidade. Este é um rótulo interno que identifica exclusivamente a relação entre uma entidade do comerciante e uma entidade do programa de fidelidade. O rótulo precisa ser fornecido para que o sistema possa associar os recursos abaixo (por exemplo, preço e pontos) a um comerciante. O programa correspondente precisa estar vinculado à conta do comerciante.
tier_label

string

O rótulo do nível no programa de fidelidade. Precisa corresponder a um dos rótulos dentro do programa.
price

Price

O preço para membros de um determinado nível, ou seja, o preço com desconto instantâneo. Precisa ser menor ou igual ao preço normal.
cashback_for_future_use

Price

O cashback que pode ser usado em compras futuras.
loyalty_points

int64

A quantidade de pontos de fidelidade ganhos em uma compra.

Produto

O produto processado, criado com base em várias [entradas de produtos][[google.shopping.content.bundles.Products.ProductInput] após a aplicação de regras e fontes de dados complementares. Esse produto processado corresponde ao que é exibido na sua conta do Merchant Center, nos anúncios do Shopping e em outras plataformas do Google. Cada produto é criado com base em exatamente uma entrada de produto de fonte de dados principal e várias entradas complementares. Depois de inserir, atualizar ou excluir uma entrada de produto, pode levar vários minutos até que o produto processado atualizado possa ser recuperado.

Todos os campos do produto processado e das submensagens dele correspondem ao nome do atributo correspondente na especificação dos dados do produto, com algumas exceções.

Campos
name

string

É o nome do produto. Formato: "{product.name=accounts/{account}/products/{product}}"
channel

ChannelEnum

Apenas saída. O canal do produto.
offer_id

string

Apenas saída. O identificador exclusivo do produto. O mesmo vale para a entrada de produto e o produto processado. Os espaços em branco à esquerda e à direita são removidos e vários espaços em branco são substituídos por um único espaço em branco no envio. Consulte a especificação dos dados do produto para mais detalhes.
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.
data_source

string

Apenas saída. A fonte de dados principal 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 pelo comerciante). Ele também pode ser usado para enviar qualquer atributo da especificação de dados na forma genérica (por exemplo, { "name": "size type", "value": "regular" }). Isso é útil para enviar atributos não expostos explicitamente pela API, como outros atributos usados no Comprar com o Google.
product_status

ProductStatus

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

int64

Apenas saída. Representa a versão existente (atualização) do produto, que pode ser usada para preservar a ordem correta quando várias atualizações são feitas ao mesmo tempo.

Se definido, a inserção será impedida quando o número da versão for menor que o número da versão atual do produto existente. A reinserção (por exemplo, atualização de produto após 30 dias) pode ser realizada com o version_number atual.

Compatível apenas com inserções em fontes de dados principais.

Se a operação for impedida, a exceção cancelada será lançada.

ProductDetail

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 dos detalhes do produto.
attribute_value

string

O valor dos detalhes 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"

ProductInput

Esse recurso representa os dados de entrada que você envia para um produto, não o produto processado que aparece no Merchant Center, nos anúncios do Shopping ou nas plataformas do Google. As entradas, as regras e os dados de fontes de dados complementares do produto são combinados para criar o [product][google.shopping.content.bundles.Products.Product] processado.

Os atributos de entrada do produto obrigatórios para passar nas verificações de validação de dados são definidos principalmente na Especificação de dados do produto.

Os seguintes atributos são obrigatórios: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] e [offerId][google.shopping.content.bundles.Products.offer_id].

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

Todos os campos da entrada do produto e das submensagens correspondem ao nome em inglês do atributo correspondente na especificação da indústria, com algumas exceções.

Campos
name

string

Identificador. O nome da entrada do produto. Formato: "{productinput.name=accounts/{account}/productInputs/{productinput}}"
product

string

Apenas saída. O nome do produto processado. Formato: "{product.name=accounts/{account}/products/{product}}"
channel

ChannelEnum

Obrigatório. Imutável. O canal do produto.
offer_id

string

Obrigatório. Imutável. O identificador exclusivo do produto. O mesmo vale para a entrada de produto e o produto processado. Os espaços em branco à esquerda e à direita são removidos e vários espaços em branco são substituídos por um único espaço em branco no envio. Para mais detalhes, consulte a especificação dos dados do produto.
content_language

string

Obrigatório. Imutável. O código de idioma ISO 639-1 de duas letras do produto.
feed_label

string

Obrigatório. Imutável. O rótulo do feed do produto.
attributes

Attributes

Opcional. Uma lista de atributos do produto.
custom_attributes[]

CustomAttribute

Opcional. Uma lista de atributos personalizados (fornecidos pelo comerciante). Ele também pode ser usado para enviar qualquer atributo da especificação de dados na forma genérica (por exemplo, { "name": "size type", "value": "regular" }). Isso é útil para enviar atributos não expostos explicitamente pela API, como outros atributos usados no Comprar com o Google. O número máximo permitido de caracteres para cada atributo personalizado é 10.240 (representa a soma de caracteres para nome e valor). É possível definir no máximo 2.500 atributos personalizados por produto, com tamanho total de 102,4 KB. Os sublinhados nos nomes de atributos personalizados são substituídos por espaços na inserção.
version_number

int64

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

Se definido, a inserção será impedida quando o número da versão for menor que o número da versão atual do produto existente. A reinserção (por exemplo, atualização de produto após 30 dias) pode ser realizada com o version_number atual.

Compatível apenas com inserções em fontes de dados principais.

Se a operação for impedida, a exceção cancelada será lançada.

ProductStatus

o status de um produto, problemas de validação de dados, ou seja, informações sobre um produto computado 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

É a data em que o item foi criado, no formato ISO 8601.
last_update_date

Timestamp

Data da última atualização do item, no formato ISO 8601.
google_expiration_date

Timestamp

É a data em que o item expira, no formato ISO 8601.

DestinationStatus

O status do destino do status do produto.

Campos
reporting_context

ReportingContextEnum

O nome do contexto do relatório.
approved_countries[]

string

Lista de códigos dos países (ISO 3166-1 alfa-2) em que a oferta foi aprovada.
pending_countries[]

string

Lista de códigos dos países (ISO 3166-1 alfa-2) em que a aprovação da oferta está pendente.
disapproved_countries[]

string

Lista de códigos dos países (ISO 3166-1 alfa-2) em que a oferta foi reprovada.

ItemLevelIssue

O ItemLevelIssue do status do produto.

Campos
code

string

O código de erro do problema.
severity

Severity

Como esse problema afeta a veiculação da oferta.
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.
reporting_context

ReportingContextEnum

O contexto do relatório em 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 o problema.
applicable_countries[]

string

Lista de códigos de país (ISO 3166-1 alfa-2) onde o problema se aplica à oferta.

Gravidade

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

Tipos enumerados
SEVERITY_UNSPECIFIED Não especificado.
NOT_IMPACTED Esse problema representa um alerta e não tem efeito direto no produto.
DEMOTED O produto foi rebaixado e provavelmente tem performance limitada nos resultados da pesquisa
DISAPPROVED O problema reprova o produto.

ProductStructuredDescription

Descrição estruturada, para descrições geradas por algoritmos (IA).

Campos
digital_source_type

string

O tipo de origem digital, por exemplo, "trained_algorithmic_media". Seguindo o IPTC. O tamanho máximo é de 40 caracteres.
content

string

O texto de descrição pode ter até 5.000 caracteres

ProductStructuredTitle

Título estruturado para títulos gerados por algoritmos (IA).

Campos
digital_source_type

string

O tipo de origem digital, por exemplo, "trained_algorithmic_media". Seguindo o IPTC. O tamanho máximo é de 40 caracteres.
content

string

O texto do título O tamanho máximo é de 150 caracteres

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"

Frete

O frete do produto.

Campos
price

Price

Preço fixo do frete, representado como um número.
country

string

O código de território CLDR do país para o qual um item será enviado.
region

string

A região geográfica à qual uma taxa de frete se aplica. Consulte region para mais informações.
service

string

Uma descrição em formato livre da classe de serviço ou velocidade de entrega.
location_id

int64

O ID numérico de um local ao qual a taxa de frete se aplica, conforme definido na API AdWords.
location_group_name

string

O local onde o frete é aplicável, representado por um nome de grupo por locais.
postal_code

string

O intervalo de códigos postais ao qual a taxa de frete se aplica, representado por um código postal, um prefixo de código postal seguido por um caractere curinga *, um intervalo entre dois códigos postais ou dois prefixos de código postal de comprimento igual.
min_handling_time

int64

Tempo em separação mínimo (inclusive) entre o recebimento e o envio do pedido em dias úteis. 0 significa que o pedido será enviado no mesmo dia em que for recebido, caso seja enviado antes do horário limite. [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] só podem estar presentes com [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time], mas não é necessário se [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] está presente.
max_handling_time

int64

Tempo em separação máximo (inclusivo) entre o recebimento e o envio do pedido em dias úteis. 0 significa que o pedido será enviado no mesmo dia em que for recebido, caso seja enviado antes do horário limite. As velocidades de envio são obrigatórias para [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] e [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. O atributo [minHandlingTime][google.shopping.content.bundles.Products.Shipping.min_handling_time] será opcional se o atributo [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] estiver presente.
min_transit_time

int64

Tempo mínimo em trânsito (inclusive) em dias úteis entre o envio do pedido e a entrega. 0 significa que o pedido é entregue no mesmo dia em que é enviado. O atributo [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] só pode estar presente com [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. No entanto, isso não é necessário se o atributo [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] estiver presente.
max_transit_time

int64

Tempo máximo em trânsito (inclusive) em dias úteis entre o envio do pedido e a entrega. 0 significa que o pedido é entregue no mesmo dia em que é enviado. As velocidades de envio são obrigatórias para [maxHandlingTime][google.shopping.content.bundles.Products.Shipping.max_handling_time] e [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time]. O atributo [minTransitTime][google.shopping.content.bundles.Products.Shipping.min_transit_time] será opcional se [maxTransitTime][google.shopping.content.bundles.Products.Shipping.max_transit_time] estiver presente.

ShippingDimension

O ShippingDimension do produto.

Campos
value

double

A dimensão do produto usada para calcular o custo de envio do item.
unit

string

A unidade de valor.

ShippingWeight

O peso de embalagem do produto.

Campos
value

double

O peso do produto usado para calcular o custo de envio do item.
unit

string

A unidade de valor.

SubscriptionCost

O custo da assinatura 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 tem que pagar por período de assinatura.

SubscriptionPeriod

O período de assinatura do produto.

Tipos enumerados
SUBSCRIPTION_PERIOD_UNSPECIFIED Indica que o período de assinatura não foi especificado.
MONTH Indica que o período de assinatura é um mês.
YEAR Indica que o período de assinatura é um ano.

Tributos

O tributo do produto.

Campos
rate

double

A porcentagem da taxa de tributos que se aplica ao preço do item.
country

string

O país no qual o item é tributado, especificado como um código de território CLDR.
region

string

A região geográfica à qual a alíquota se aplica.
tax_ship

bool

Defina como verdadeiro se os tributos forem cobrados no frete.
location_id

int64

O ID numérico de um local ao qual a alíquota tributária se aplica, conforme definido na API AdWords.
postal_code

string

O intervalo de CEP ao qual a taxa de impostos se aplica, representado por um CEP, um prefixo de CEP usando o caractere curinga *, um intervalo entre dois CEPs ou dois prefixos de CEP de comprimento igual. Exemplos: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingBaseMeasure

O UnitPricingBaseMeasure do produto.

Campos
value

int64

O denominador do preço unitário.
unit

string

A unidade do denominador.

UnitPricingMeasure

A métrica de preços unitários do produto.

Campos
value

double

A medida de um item.
unit

string

A unidade da medida.