REST Resource: accounts.products

Recurso: product

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.

Representação JSON 
{
  "name": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "dataSource": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "productStatus": {
    object (ProductStatus)
  },
  "versionNumber": string
}
Campos
name

string

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

enum (ChannelEnum)

Apenas saída. O canal do produto.
offerId

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

string

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

string

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

string

Apenas saída. A fonte de dados principal do produto.
attributes

object (Attributes)

Apenas saída. Uma lista de atributos do produto.
customAttributes[]

object (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.
productStatus

object (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.
versionNumber

string (int64 format)

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

Atributos

Atributos.

Representação JSON 
{
  "additionalImageLinks": [
    string
  ],
  "expirationDate": string,
  "disclosureDate": string,
  "availabilityDate": string,
  "price": {
    object (Price)
  },
  "installment": {
    object (Installment)
  },
  "subscriptionCost": {
    object (SubscriptionCost)
  },
  "loyaltyPoints": {
    object (LoyaltyPoints)
  },
  "loyaltyPrograms": [
    {
      object (LoyaltyProgram)
    }
  ],
  "productTypes": [
    string
  ],
  "salePrice": {
    object (Price)
  },
  "salePriceEffectiveDate": {
    object (Interval)
  },
  "productHeight": {
    object (ProductDimension)
  },
  "productLength": {
    object (ProductDimension)
  },
  "productWidth": {
    object (ProductDimension)
  },
  "productWeight": {
    object (ProductWeight)
  },
  "shipping": [
    {
      object (Shipping)
    }
  ],
  "freeShippingThreshold": [
    {
      object (FreeShippingThreshold)
    }
  ],
  "shippingWeight": {
    object (ShippingWeight)
  },
  "shippingLength": {
    object (ShippingDimension)
  },
  "shippingWidth": {
    object (ShippingDimension)
  },
  "shippingHeight": {
    object (ShippingDimension)
  },
  "sizeTypes": [
    string
  ],
  "taxes": [
    {
      object (Tax)
    }
  ],
  "unitPricingMeasure": {
    object (UnitPricingMeasure)
  },
  "unitPricingBaseMeasure": {
    object (UnitPricingBaseMeasure)
  },
  "adsLabels": [
    string
  ],
  "costOfGoodsSold": {
    object (Price)
  },
  "productDetails": [
    {
      object (ProductDetail)
    }
  ],
  "productHighlights": [
    string
  ],
  "displayAdsSimilarIds": [
    string
  ],
  "promotionIds": [
    string
  ],
  "includedDestinations": [
    string
  ],
  "excludedDestinations": [
    string
  ],
  "shoppingAdsExcludedCountries": [
    string
  ],
  "lifestyleImageLinks": [
    string
  ],
  "cloudExportAdditionalProperties": [
    {
      object (CloudExportAdditionalProperties)
    }
  ],
  "certifications": [
    {
      object (Certification)
    }
  ],
  "autoPricingMinPrice": {
    object (Price)
  },
  "identifierExists": boolean,
  "isBundle": boolean,
  "title": string,
  "description": string,
  "link": string,
  "mobileLink": string,
  "canonicalLink": string,
  "imageLink": string,
  "adult": boolean,
  "ageGroup": string,
  "availability": string,
  "brand": string,
  "color": string,
  "condition": string,
  "gender": string,
  "googleProductCategory": string,
  "gtin": string,
  "itemGroupId": string,
  "material": string,
  "mpn": string,
  "pattern": string,
  "sellOnGoogleQuantity": string,
  "maxHandlingTime": string,
  "minHandlingTime": string,
  "shippingLabel": string,
  "transitTimeLabel": string,
  "size": string,
  "sizeSystem": string,
  "taxCategory": string,
  "energyEfficiencyClass": string,
  "minEnergyEfficiencyClass": string,
  "maxEnergyEfficiencyClass": string,
  "multipack": string,
  "adsGrouping": string,
  "adsRedirect": string,
  "displayAdsId": string,
  "displayAdsTitle": string,
  "displayAdsLink": string,
  "displayAdsValue": number,
  "pickupMethod": string,
  "pickupSla": string,
  "linkTemplate": string,
  "mobileLinkTemplate": string,
  "customLabel0": string,
  "customLabel1": string,
  "customLabel2": string,
  "customLabel3": string,
  "customLabel4": string,
  "externalSellerId": string,
  "pause": string,
  "virtualModelLink": string,
  "structuredTitle": {
    object (ProductStructuredTitle)
  },
  "structuredDescription": {
    object (ProductStructuredDescription)
  }
}
Campos
expirationDate

string (Timestamp format)

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

string (Timestamp format)

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

string (Timestamp format)

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

object (Price)

Preço do item.
installment

object (Installment)

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

object (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.
loyaltyPoints

object (LoyaltyPoints)

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

object (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.
productTypes[]

string

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

object (Price)

Preço promocional anunciado do item.
salePriceEffectiveDate

object (Interval)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductDimension)

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

object (ProductWeight)

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

object (Shipping)

Regras de envio.
freeShippingThreshold[]

object (FreeShippingThreshold)

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

object (ShippingWeight)

Peso do item para envio.
shippingLength

object (ShippingDimension)

Comprimento do item para envio.
shippingWidth

object (ShippingDimension)

Largura do item para envio.
shippingHeight

object (ShippingDimension)

Altura do item para envio.
sizeTypes[]

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[]

object (Tax)

Informações fiscais.
unitPricingMeasure

object (UnitPricingMeasure)

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

object (UnitPricingBaseMeasure)

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

string

Semelhante ao adsGrouping, mas funciona apenas com CPC.
costOfGoodsSold

object (Price)

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

object (ProductDetail)

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

string

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

string

Recomendações especificadas pelo anunciante.
promotionIds[]

string

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

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.
excludedDestinations[]

string

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

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.
cloudExportAdditionalProperties[]

object (CloudExportAdditionalProperties)

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

object (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.
autoPricingMinPrice

object (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.
identifierExists

boolean

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

boolean

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

boolean

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

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

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string

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

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

string

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

string

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

string

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

string

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

string

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

string (int64 format)

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

string

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

string

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

string

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

string

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

number

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

string

A opção de retirada do item.
pickupSla

string

Cronograma de retirada do item na loja.
customLabel0

string

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

string

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

string

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

string

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

string

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

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

object (ProductStructuredTitle)

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

object (ProductStructuredDescription)

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

Parcelas

Uma mensagem que representa parcelas.

Representação JSON 
{
  "months": string,
  "amount": {
    object (Price)
  },
  "downpayment": {
    object (Price)
  },
  "creditType": string
}
Campos
months

string (int64 format)

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

object (Price)

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

object (Price)

O valor da entrada que o comprador precisa pagar.
creditType

string

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

SubscriptionCost

O custo da assinatura do produto.

Representação JSON 
{
  "period": enum (SubscriptionPeriod),
  "periodLength": string,
  "amount": {
    object (Price)
  }
}
Campos
period

enum (SubscriptionPeriod)

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

string (int64 format)

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

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

LoyaltyPoints

Uma mensagem que representa os pontos de fidelidade.

Representação JSON 
{
  "name": string,
  "pointsValue": string,
  "ratio": number
}
Campos
name

string

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

string (int64 format)

Os pontos de fidelidade do varejista em valor absoluto.
ratio

number

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.

Representação JSON 
{
  "programLabel": string,
  "tierLabel": string,
  "price": {
    object (Price)
  },
  "cashbackForFutureUse": {
    object (Price)
  },
  "loyaltyPoints": string
}
Campos
programLabel

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

string

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

object (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.
cashbackForFutureUse

object (Price)

O cashback que pode ser usado em compras futuras.
loyaltyPoints

string (int64 format)

A quantidade de pontos de fidelidade ganhos em uma compra.

ProductDimension

A dimensão do produto.

Representação JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

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.

Representação JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

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.

Representação JSON 
{
  "price": {
    object (Price)
  },
  "country": string,
  "region": string,
  "service": string,
  "locationId": string,
  "locationGroupName": string,
  "postalCode": string,
  "minHandlingTime": string,
  "maxHandlingTime": string,
  "minTransitTime": string,
  "maxTransitTime": string
}
Campos
price

object (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.
locationId

string (int64 format)

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

string

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

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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

string (int64 format)

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.

FreeShippingThreshold

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

Representação JSON 
{
  "country": string,
  "priceThreshold": {
    object (Price)
  }
}
Campos
country

string

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

object (Price)

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

ShippingWeight

O peso de embalagem do produto.

Representação JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

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

string

A unidade de valor.

ShippingDimension

O ShippingDimension do produto.

Representação JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

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

string

A unidade de valor.

Tributos

O tributo do produto.

Representação JSON 
{
  "rate": number,
  "country": string,
  "region": string,
  "taxShip": boolean,
  "locationId": string,
  "postalCode": string
}
Campos
rate

number

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

boolean

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

string (int64 format)

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

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

UnitPricingMeasure

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

Representação JSON 
{
  "value": number,
  "unit": string
}
Campos
value

number

A medida de um item.
unit

string

A unidade da medida.

UnitPricingBaseMeasure

O UnitPricingBaseMeasure do produto.

Representação JSON 
{
  "value": string,
  "unit": string
}
Campos
value

string (int64 format)

O denominador do preço unitário.
unit

string

A unidade do denominador.

ProductDetail

Detalhes do produto.

Representação JSON 
{
  "sectionName": string,
  "attributeName": string,
  "attributeValue": string
}
Campos
sectionName

string

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

string

O nome dos detalhes do produto.
attributeValue

string

O valor dos detalhes do produto.

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

Representação JSON 
{
  "textValue": [
    string
  ],
  "intValue": [
    string
  ],
  "floatValue": [
    number
  ],
  "propertyName": string,
  "boolValue": boolean,
  "minValue": number,
  "maxValue": number,
  "unitCode": string
}
Campos
textValue[]

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.
intValue[]

string (int64 format)

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.
floatValue[]

number

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

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

boolean

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

number

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

number

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

string

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

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.

Representação JSON 
{
  "certificationAuthority": string,
  "certificationName": string,
  "certificationCode": string,
  "certificationValue": string
}
Campos
certificationAuthority

string

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

string

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

string

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

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.

ProductStructuredTitle

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

Representação JSON 
{
  "digitalSourceType": string,
  "content": string
}
Campos
digitalSourceType

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

ProductStructuredDescription

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

Representação JSON 
{
  "digitalSourceType": string,
  "content": string
}
Campos
digitalSourceType

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

ProductStatus

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

Representação JSON 
{
  "destinationStatuses": [
    {
      object (DestinationStatus)
    }
  ],
  "itemLevelIssues": [
    {
      object (ItemLevelIssue)
    }
  ],
  "creationDate": string,
  "lastUpdateDate": string,
  "googleExpirationDate": string
}
Campos
destinationStatuses[]

object (DestinationStatus)

Os destinos pretendidos do produto.
itemLevelIssues[]

object (ItemLevelIssue)

Uma lista de todos os problemas associados ao produto.
creationDate

string (Timestamp format)

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

string (Timestamp format)

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

string (Timestamp format)

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

DestinationStatus

O status do destino do status do produto.

Representação JSON 
{
  "reportingContext": enum (ReportingContextEnum),
  "approvedCountries": [
    string
  ],
  "pendingCountries": [
    string
  ],
  "disapprovedCountries": [
    string
  ]
}
Campos
reportingContext

enum (ReportingContextEnum)

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

string

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

string

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

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.

Representação JSON 
{
  "code": string,
  "severity": enum (Severity),
  "resolution": string,
  "attribute": string,
  "reportingContext": enum (ReportingContextEnum),
  "description": string,
  "detail": string,
  "documentation": string,
  "applicableCountries": [
    string
  ]
}
Campos
code

string

O código de erro do problema.
severity

enum (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.
reportingContext

enum (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.
applicableCountries[]

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.

Métodos

get

 Recupera o produto processado da sua conta do Merchant Center.

list

 Lista os produtos processados na sua conta do Merchant Center.