Package google.shopping.merchant.products.v1beta

Índice

ProductInputsService

Serviço para usar o recurso ProductInput. Esse serviço funciona apenas para produtos com 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 OAuth 2.0 Overview.
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, esse método vai 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 OAuth 2.0 Overview.

Serviço de produtos

Serviço para usar o recurso de produto. Esse serviço funciona apenas para produtos com 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 OAuth 2.0 Overview.
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 alguns minutos para que o produto processado 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.

Atributos

Atributos.

Campos
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 mais cedo se expirationDate estiver muito distante.
disclosure_date

Timestamp

A data e a hora em que uma oferta vai aparecer 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 de pré-encomenda fica disponível para entrega, no formato ISO 8601.
gtin[]

string

Números globais de item comercial (GTIN) do item. Você pode fornecer até 10 GTINs.
price

Price

Preço do item.
installment

Installment

Número e valor das parcelas para pagar um item.
subscription_cost

SubscriptionCost

Número de períodos (meses ou anos) e valor do pagamento por período de 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 usada para mostrar benefícios de fidelidade (por exemplo, preços melhores, pontos etc.) ao usuário desse item.
product_types[]

string

Categorias do item (formatadas conforme a especificação dos dados do produto).
sale_price

Price

Preço de venda do item anunciado.
sale_price_effective_date

Interval

Período de promoção do item (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 (inclusive).
product_length

ProductDimension

A duração do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 3.000 (inclusive).
product_width

ProductDimension

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

ProductWeight

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

Shipping

Regras de frete.
free_shipping_threshold[]

FreeShippingThreshold

Condições que precisam ser atendidas para que um 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 a ads_grouping, mas só funciona com CPC.
cost_of_goods_sold

Price

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

ProductDetail

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

string

Pontos que descrevem os destaques 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

Lista de destinos a serem incluídos nessa 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

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 dessa lista são removidos dos países configurados nas configurações da fonte de dados.
cloud_export_additional_properties[]

CloudExportAdditionalProperties

Campos extras para exportar para o programa Cloud Retail.
certifications[]

Certification

Certificações de produtos, por exemplo, para rotulagem de eficiência energética de produtos registrados no banco de dados do EPREL da UE. Consulte o artigo da Central de Ajuda para mais informações.
auto_pricing_min_price

Price

Uma proteção nos projetos "Descontos automatizados" (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.
sustainability_incentives[]

ProductSustainabilityIncentive

A lista de programas de incentivo à sustentabilidade.
identifier_exists

bool

Defina esse valor como falso quando o item não tiver identificadores exclusivos de produto adequados à categoria, como GTIN, MPN e marca. O padrão é "true", se não for fornecido.
is_bundle

bool

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

string

Título do item.
description

string

Descrição do item.
adult

bool

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

string

Direcionar o item a uma faixa etária.
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 a que o item é voltado.
google_product_category

string

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 é possível recuperar as categorias de produtos do Google atribuídas automaticamente pela API.
item_group_id

string

Identificador compartilhado para 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

O padrão do item (por exemplo, bolinhas).
sell_on_google_quantity

int64

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

int64

Tempo máximo de processamento do produto (em dias úteis).
min_handling_time

int64

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

string

O rótulo para envio do produto, usado para agrupar produtos 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 itens em 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.
energy_efficiency_class

string

A classe de eficiência energética conforme definida na Diretiva 2010/30/UE da UE.
min_energy_efficiency_class

string

A classe de eficiência energética conforme definida na Diretiva 2010/30/UE da UE.
max_energy_efficiency_class

string

A classe de eficiência energética conforme definida na Diretiva 2010/30/UE da UE.
multipack

int64

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

string

Usado para agrupar itens de forma arbitrária. Apenas para CPA%. Não é recomendado usar outra coisa.
ads_redirect

string

Permite que os anunciantes substituam o URL do item quando o produto é mostrado no 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 de 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 que envia produtos para vários vendedores com uma 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 algoritmo (IA).
structured_description

ProductStructuredDescription

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

Certificação

Certificação do produto, introduzida inicialmente para a 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 de 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 nota), por exemplo, "A+", "C", "ouro". O tamanho máximo é de 2.000 caracteres.

CloudExportAdditionalProperties

Propriedade do produto para a 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(UHD)" 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. 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, "True" ou "False" se a tela for UHD.
min_value

float

Valor mínimo de ponto flutuante da propriedade. Por exemplo, para um produto de TV 1.00.
max_value

float

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

string

Unidade da propriedade. 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}, em que a última seção product consiste em quatro partes: canal~content_language~feed_label~offer_id. Por exemplo, o nome do produto é "accounts/123/productInputs/online~en~US~sku123".
data_source

string

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

FreeShippingThreshold

Condições que precisam ser atendidas para que um produto tenha frete grátis.

Campos
country

string

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

Price

O preço mínimo do produto para que o custo do frete seja 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}, em que a última seção product consiste em quatro partes: canal~idioma_do_conteúdo~rótulo_do_feed~id_da_oferta. Por exemplo, o nome do produto é "contas/123/produtos/on-line~pt-BR~US~sku123".

InsertProductInputRequest

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

Campos
parent

string

Obrigatório. A conta em que o 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 de produtos principal ou complementar. Se o produto já existir e a origem de dados fornecida for diferente, ele será movido para uma nova origem.

Somente fontes de dados de API são aceitas.

Formato: accounts/{account}/dataSources/{datasource}.

Parcela

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 que o comprador precisa pagar.
credit_type

string

Tipo de pagamentos parcelados. 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 é 250. Valores acima disso serão convertidos para 250. Se não for especificado, o número máximo de produtos será retornado.
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 os 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 pontos de fidelidade.

Campos
name

string

Nome do programa de pontos de fidelidade. Recomendamos 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 convertido em moeda. O Google assume a moeda com base nas configurações do Merchant Center. Se a proporção não for especificada, 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. É 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 do programa.
price

Price

O preço para os membros do nível, ou seja, o preço do 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.
member_price_effective_date

Interval

Um período em que o item está qualificado para o preço de membro. Se não for especificado, o preço de membro sempre será aplicado. O período é representado por um par de datas ISO 8601 separadas por espaço, vírgula ou barra.
shipping_label

string

O rótulo do benefício de frete. Se o campo tiver um valor, a oferta terá o benefício de frete do programa de fidelidade. Se o valor do campo não for fornecido, o item não estará qualificado para o frete do programa de fidelidade para o nível de fidelidade especificado.

Produto

O produto processado, criado a partir de vários product inputs após a aplicação de regras e fontes de dados complementares. Esse produto processado corresponde ao que é mostrado na sua conta do Merchant Center, nos anúncios do Shopping e em outras plataformas do Google. Cada produto é criado com exatamente uma entrada de produto da fonte de dados principal e várias entradas de fonte de dados complementares. Depois de inserir, atualizar ou excluir uma entrada de produto, pode levar alguns minutos para que o produto processado atualizado seja recuperado.

Todos os campos no produto processado e as submensagens 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}}", em que a última seção product consiste em quatro partes: canal~idioma_do_conteúdo~rótulo_do_feed~id_da_oferta. Por exemplo, o nome do produto é "contas/123/produtos/on-line~pt-BR~US~sku123".
channel

ChannelEnum

Apenas saída. O canal do produto.
offer_id

string

Apenas saída. Seu identificador exclusivo do produto. Isso é o mesmo para a entrada e o produto processado. Os espaços em branco iniciais e finais são removidos, e vários espaços em branco são substituídos por um único espaço após o 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). Também é possível usar o atributo genérico { "name": "size type", "value": "regular" } para enviar qualquer atributo da especificação de dados. Isso é útil para enviar atributos não expostos explicitamente pela API, como atributos adicionais 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 calculado de forma assíncrona.
version_number

int64

Apenas saída. Representa a versão atual (novidade) 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 é impedida quando o número da versão é menor que o número da versão atual do produto. A reinserção (por exemplo, atualização do produto após 30 dias) pode ser realizada com o version_number atual.

Somente para inserções em fontes de dados principais.

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

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"

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 no Google plataformas. As entradas de produtos, as regras e os dados da fonte de dados complementares são combinados para criar o Product processado.

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

Os seguintes atributos são obrigatórios: feedLabel, contentLanguage e offerId.

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

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

Campos
name

string

Identificador. O nome da entrada do produto. Formato: "{productinput.name=accounts/{account}/productInputs/{productinput}}", em que a última seção productinput consiste em quatro partes: canal~content_language~feed_label~offer_id. Por exemplo, o nome da entrada de produto é "accounts/123/productInputs/online~en~US~sku123".
product

string

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

ChannelEnum

Imutável. O canal do produto.
offer_id

string

Obrigatório. Imutável. Seu identificador exclusivo do produto. Isso é o mesmo para a entrada e o produto processado. Os espaços em branco iniciais e finais são removidos, e vários espaços em branco são substituídos por um único espaço após o envio. Consulte a especificação dos dados de produtos para mais detalhes.
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 atributos adicionais usados no Comprar com o Google. O número máximo de caracteres permitido para cada atributo personalizado é 10240 (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 atual (novidade) 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 é impedida quando o número da versão é menor que o número da versão atual do produto. A reinserção (por exemplo, atualização do produto após 30 dias) pode ser realizada com o version_number atual.

Somente para inserções em fontes de dados principais.

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

ProductStatus

O status de um produto, problemas de validação de dados, ou seja, informações sobre um produto calculado 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 da última atualização do item, no formato ISO 8601.
google_expiration_date

Timestamp

Data de expiração do item, no formato ISO 8601.

DestinationStatus

O status de destino do produto.

Campos
reporting_context

ReportingContextEnum

O nome do contexto de relatórios.
approved_countries[]

string

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

string

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

string

Lista de códigos de 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 ao qual 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 à oferta.

Gravidade

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

Enums
SEVERITY_UNSPECIFIED Não especificado.
NOT_IMPACTED Esse problema representa um aviso e não tem um efeito direto no produto.
DEMOTED O produto é rebaixado e provavelmente tem desempenho limitado 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 IPTC. O tamanho máximo é de 40 caracteres.
content

string

O tamanho máximo do texto da descrição é de 5.000 caracteres

ProductStructuredTitle

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

Campos
digital_source_type

string

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

string

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

ProductSustainabilityIncentive

Informações sobre programas de incentivo relacionados à sustentabilidade, como descontos ou isenção de impostos.

Campos
Campo de união value. Valor do incentivo à sustentabilidade. value pode ser apenas de um dos tipos a seguir:
amount

Price

O valor fixo do incentivo.
percentage

double

A porcentagem do preço promocional em que o incentivo é aplicado.
type

Type

Programa de incentivo à sustentabilidade.

Tipo

Tipos de programas de incentivo à sustentabilidade aceitos.

Enums
TYPE_UNSPECIFIED Tipo de incentivo de sustentabilidade não especificado ou desconhecido.
EV_TAX_CREDIT Programa que oferece reduções de responsabilidade tributária para veículos elétricos e, em alguns países, híbridos plug-in. Essas reduções podem ser baseadas em um valor específico ou em uma porcentagem do preço de venda.
EV_PRICE_DISCOUNT Um programa de subsídios, muitas vezes chamado de bônus ambiental, oferece um subsídio de compra para veículos elétricos e, em alguns países, híbridos plug-in. O valor da concessão pode ser uma quantia fixa ou uma porcentagem do preço de venda.

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 envio do produto.

Campos
price

Price

Preço de frete fixo, representado por um número.
country

string

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

string

A região geográfica a que uma taxa de frete se aplica. Consulte região 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 a que a taxa de frete se aplica, conforme definido na API Google Ads.
location_group_name

string

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

string

O intervalo de códigos postais em que a taxa de frete é válida, representado por um código postal, um prefixo de código postal seguido de um caractere curinga *, um intervalo entre dois códigos postais ou dois prefixos de código postal de mesma duração.
min_handling_time

int64

Tempo mínimo em separação (inclusive) entre o recebimento e o envio do pedido em dias úteis. 0 significa que o pedido é enviado no mesmo dia em que é recebido, se isso acontecer antes do horário limite. minHandlingTime só pode estar presente com maxHandlingTime, mas não é necessário se maxHandlingTime estiver presente.
max_handling_time

int64

Tempo máximo em separação (inclusive) entre o recebimento e o envio do pedido em dias úteis. 0 significa que o pedido é enviado no mesmo dia em que é recebido, se isso acontecer antes do horário limite. maxHandlingTime e maxTransitTime são obrigatórios se você informar as velocidades de frete. minHandlingTime é opcional se maxHandlingTime estiver presente.
min_transit_time

int64

Tempo mínimo em trânsito (inclusive) entre o envio e a entrega do pedido em dias úteis. 0 significa que o pedido é entregue no mesmo dia em que é enviado. minTransitTime só pode estar presente com maxTransitTime, mas não é necessário se maxTransitTime estiver presente.
max_transit_time

int64

Tempo máximo em trânsito (inclusive) entre o envio e a entrega do pedido em dias úteis. 0 significa que o pedido é entregue no mesmo dia em que é enviado. maxHandlingTime e maxTransitTime são obrigatórios se você informar as velocidades de frete. minTransitTime é opcional se maxTransitTime estiver presente.

ShippingDimension

A ShippingDimension do produto.

Campos
value

double

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

string

A unidade de valor.

ShippingWeight

O ShippingWeight do produto.

Campos
value

double

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

string

A unidade de valor.

SubscriptionCost

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.

SubscriptionPeriod

O período de assinatura do produto.

Enums
SUBSCRIPTION_PERIOD_UNSPECIFIED Indica que o período da assinatura não está especificado.
MONTH Indica que o período de assinatura é mensal.
YEAR Indica que o período de assinatura é anual.

Tributo

O imposto do produto.

Campos
rate

double

A porcentagem da alíquota de imposto que se aplica ao preço do item.
country

string

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

string

A região geográfica a que a alíquota de imposto se aplica.
tax_ship

bool

Defina como "true" se o imposto for cobrado no frete.
location_id

int64

O ID numérico de um local a que a alíquota de imposto se aplica, conforme definido na API Google Ads.
postal_code

string

O intervalo de códigos postais a que a alíquota de imposto 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 mesma extensão. Exemplos: 94114, 94*, 94002-95460, 94*-95*.

UnitPricingBaseMeasure

A UnitPricingBaseMeasure do produto.

Campos
value

int64

O denominador do preço unitário.
unit

string

A unidade do denominador.

UnitPricingMeasure

A UnitPricingMeasure do produto.

Campos
value

double

A medida de um item.
unit

string

A unidade de medida.