- Representação JSON
- Parcela
- SubscriptionCost
- SubscriptionPeriod
- LoyaltyPoints
- LoyaltyProgram
- ProductDimension
- ProductWeight
- Frete
- FreeShippingThreshold
- ShippingWeight
- ShippingDimension
- Tributos
- UnitPricingMeasure
- UnitPricingBaseMeasure
- ProductDetail
- CloudExportAdditionalProperties
- Certificação
- ProductStructuredTitle
- ProductStructuredDescription
Atributos.
Representação JSON |
---|
{ "additionalImageLinks": [ string ], "expirationDate": string, "disclosureDate": string, "availabilityDate": string, "gtin": [ string ], "price": { object ( |
Campos | |
---|---|
additional |
Outros URLs de imagens do item. |
expiration |
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 |
disclosure |
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 |
O dia em que um produto comprado na pré-venda fica disponível para entrega, no formato ISO 8601. |
gtin[] |
Números globais de item comercial (GTIN) do item. Você pode fornecer até 10 GTINs. |
price |
Preço do item. |
installment |
Número e valor das parcelas para pagar um item. |
subscription |
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 |
Pontos de fidelidade que os usuários recebem após a compra do item. Somente no Japão. |
loyalty |
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 |
Categorias do item (formatadas conforme a especificação dos dados do produto). |
sale |
Preço de venda do item anunciado. |
sale |
Período de promoção do item (consulte a especificação dos dados do produto). |
product |
A altura do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 3.000 (inclusive). |
product |
A duração do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 3.000 (inclusive). |
product |
A largura do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 3.000 (inclusive). |
product |
O peso do produto nas unidades fornecidas. O valor precisa estar entre 0 (exclusivo) e 2.000 (inclusive). |
shipping[] |
Regras de frete. |
free |
Condições que precisam ser atendidas para que um produto tenha frete grátis. |
shipping |
Peso do item para envio. |
shipping |
Comprimento do item para envio. |
shipping |
Largura do item para envio. |
shipping |
Altura do item para envio. |
size |
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[] |
Informações fiscais. |
unit |
A medida e a dimensão de um item. |
unit |
A preferência do denominador do preço unitário. |
ads |
Semelhante a adsGrouping, mas funciona apenas no CPC. |
cost |
Custo dos produtos vendidos. Usado para relatórios de lucro bruto. |
product |
Especificação técnica ou outros detalhes do produto. |
product |
Pontos que descrevem os destaques mais relevantes de um produto. |
display |
Recomendações especificadas pelo anunciante. |
promotion |
O ID exclusivo de uma promoção. |
included |
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 |
excluded |
Lista de destinos a serem excluídos dessa segmentação (corresponde às caixas de seleção desmarcadas no Merchant Center). |
shopping |
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. |
lifestyle |
Outros URLs de imagens de estilo de vida do item, usados para identificar explicitamente imagens que mostram o item em um contexto real. Consulte o artigo da Central de Ajuda para mais informações. |
cloud |
Campos extras para exportar para o programa Cloud Retail. |
certifications[] |
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 |
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. |
identifier |
Defina esse valor como "false" 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 |
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 |
Título do item. |
description |
Descrição do item. |
link |
URL que leva diretamente à página do item na sua loja on-line. |
mobile |
URL da versão otimizada para dispositivos móveis da página de destino do item. |
canonical |
URL da versão canônica da página de destino do item. |
image |
URL de uma imagem do item. |
adult |
Definido como "true" se o item for voltado a adultos. |
age |
Direcionar o item a uma faixa etária. |
availability |
Status de disponibilidade do item. |
brand |
Marca do item. |
color |
Cor do item. |
condition |
Condição ou estado do item. |
gender |
Gênero a que o item é voltado. |
google |
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 |
Identificador compartilhado para todas as variantes do mesmo produto. |
material |
Material de que o item é feito. |
mpn |
Número de peça do fabricante (MPN) do item. |
pattern |
O padrão do item (por exemplo, bolinhas). |
sell |
A quantidade do produto disponível para venda no Google. Suporte apenas para produtos on-line. |
max |
Tempo máximo de processamento do produto (em dias úteis). |
min |
Tempo mínimo de separação do produto (dias úteis). |
shipping |
O rótulo para envio do produto, usado para agrupar produtos em regras de frete no nível da conta. |
transit |
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 |
Tamanho do item. Apenas um valor é permitido. Para variantes com tamanhos diferentes, insira um produto separado para cada tamanho com o mesmo valor de |
size |
Sistema em que o tamanho é especificado. Recomendado para itens de vestuário. |
tax |
A categoria fiscal do produto, usada para configurar a presença física detalhada nas configurações de tributos no nível da conta. |
energy |
A classe de eficiência energética conforme definida na Diretiva 2010/30/UE da UE. |
min |
A classe de eficiência energética conforme definida na Diretiva 2010/30/UE da UE. |
max |
A classe de eficiência energética conforme definida na Diretiva 2010/30/UE da UE. |
multipack |
Número de produtos idênticos em um multipack definido pelo comerciante. |
ads |
Usado para agrupar itens de forma arbitrária. Apenas para CPA%. Não é recomendado usar outra coisa. |
ads |
Permite que os anunciantes substituam o URL do item quando o produto é mostrado no contexto dos anúncios de produtos. |
display |
Identificador de um item para campanhas de remarketing dinâmico. |
display |
Título de um item para campanhas de remarketing dinâmico. |
display |
URL direto para a página de destino do seu item das campanhas de remarketing dinâmico. |
display |
Margem de oferta para campanhas de remarketing dinâmico. |
pickup |
A opção de retirada do item. |
pickup |
Cronograma de retirada do item na loja. |
link |
Modelo de link para a vitrine local hospedada pelo comerciante. |
mobile |
Modelo de link para a vitrine local hospedada pelo comerciante otimizada para dispositivos móveis. |
custom |
Rótulo personalizado 0 para agrupamento personalizado de itens em uma campanha do Shopping. |
custom |
Rótulo personalizado 1 para agrupamento personalizado de itens em uma campanha do Shopping. |
custom |
Rótulo personalizado 2 para agrupamento personalizado de itens em uma campanha do Shopping. |
custom |
Rótulo personalizado 3 para agrupamento personalizado de itens em uma campanha do Shopping. |
custom |
Rótulo personalizado 4 para agrupamento personalizado de itens em uma campanha do Shopping. |
external |
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 |
A publicação deste item será pausada temporariamente. |
virtual |
URL da imagem 3D do item. Consulte o artigo da Central de Ajuda para mais informações. |
structured |
Título estruturado, para títulos gerados por algoritmo (IA). |
structured |
Descrição estruturada, para descrições geradas por algoritmos (IA). |
Parcela
Uma mensagem que representa uma parcela.
Representação JSON |
---|
{ "months": string, "amount": { object ( |
Campos | |
---|---|
months |
O número de parcelas que o comprador precisa pagar. |
amount |
O valor que o comprador precisa pagar por mês. |
downpayment |
O valor da entrada que o comprador precisa pagar. |
credit |
Tipo de pagamentos parcelados. Os valores aceitos são: * " |
SubscriptionCost
O SubscriptionCost do produto.
Representação JSON |
---|
{ "period": enum ( |
Campos | |
---|---|
period |
O tipo de período de assinatura. Os valores aceitos são: * " |
period |
O número de períodos de assinatura que o comprador precisa pagar. |
amount |
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 é de um ano. |
LoyaltyPoints
Uma mensagem que representa pontos de fidelidade.
Representação JSON |
---|
{ "name": string, "pointsValue": string, "ratio": number } |
Campos | |
---|---|
name |
Nome do programa de pontos de fidelidade. Recomendamos limitar o nome a 12 caracteres de largura total ou 24 caracteres romanos. |
points |
Os pontos de fidelidade do varejista em valor absoluto. |
ratio |
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 incluída, o padrão será 1,0. |
LoyaltyProgram
Uma mensagem que representa o programa de fidelidade.
Representação JSON |
---|
{ "programLabel": string, "tierLabel": string, "price": { object ( |
Campos | |
---|---|
program |
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 |
O rótulo do nível no programa de fidelidade. Precisa corresponder a um dos rótulos do programa. |
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 |
O cashback que pode ser usado em compras futuras. |
loyalty |
A quantidade de pontos de fidelidade ganhos em uma compra. |
member |
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 será sempre aplicado. O período é representado por um par de datas ISO 8601 separadas por espaço, vírgula ou barra. |
shipping |
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. |
ProductDimension
A dimensão do produto.
Representação JSON |
---|
{ "value": number, "unit": string } |
Campos | |
---|---|
value |
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 |
Obrigatório. As unidades de dimensão. Os valores aceitáveis são: * " |
ProductWeight
O peso do produto.
Representação JSON |
---|
{ "value": number, "unit": string } |
Campos | |
---|---|
value |
Obrigatório. O peso representado como um número. O peso pode ter uma precisão máxima de quatro casas decimais. |
unit |
Obrigatório. A unidade de peso. Os valores aceitáveis são: * " |
Frete
O envio do produto.
Representação JSON |
---|
{
"price": {
object ( |
Campos | |
---|---|
price |
Preço de frete fixo, representado por um número. |
country |
O código de território CLDR do país para onde um item será enviado. |
region |
A região geográfica a que uma taxa de frete se aplica. Consulte região para mais informações. |
service |
Uma descrição em formato livre da classe de serviço ou velocidade de entrega. |
location |
O ID numérico de um local a que a taxa de frete se aplica, conforme definido na API Google Ads. |
location |
O local onde o frete é aplicável, representado por um nome de grupo de locais. |
postal |
O intervalo de códigos postais a que a tarifa de frete se aplica, 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 extensão. |
min |
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. |
max |
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. |
min |
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. |
max |
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. |
FreeShippingThreshold
Condições que precisam ser atendidas para que um produto tenha frete grátis.
Representação JSON |
---|
{
"country": string,
"priceThreshold": {
object ( |
Campos | |
---|---|
country |
O código de território CLDR do país para onde um item será enviado. |
price |
O preço mínimo do produto para que o custo do frete seja sem custo financeiro. Representado como um número. |
ShippingWeight
O ShippingWeight do produto.
Representação JSON |
---|
{ "value": number, "unit": string } |
Campos | |
---|---|
value |
O peso do produto usado para calcular o custo de frete do item. |
unit |
A unidade de valor. |
ShippingDimension
A ShippingDimension do produto.
Representação JSON |
---|
{ "value": number, "unit": string } |
Campos | |
---|---|
value |
A dimensão do produto usada para calcular o custo de frete do item. |
unit |
A unidade de valor. |
Tributo
O imposto do produto.
Representação JSON |
---|
{ "rate": number, "country": string, "region": string, "taxShip": boolean, "locationId": string, "postalCode": string } |
Campos | |
---|---|
rate |
A porcentagem da taxa de imposto que se aplica ao preço do item. |
country |
O país em que o item é tributado, especificado como um código de território CLDR. |
region |
A região geográfica a que a alíquota de imposto se aplica. |
tax |
Defina como "true" se o imposto for cobrado no frete. |
location |
O ID numérico de um local a que a alíquota de imposto se aplica, conforme definido na API Google Ads. |
postal |
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*. |
UnitPricingMeasure
A UnitPricingMeasure do produto.
Representação JSON |
---|
{ "value": number, "unit": string } |
Campos | |
---|---|
value |
A medida de um item. |
unit |
A unidade de medida. |
UnitPricingBaseMeasure
A UnitPricingBaseMeasure do produto.
Representação JSON |
---|
{ "value": string, "unit": string } |
Campos | |
---|---|
value |
O denominador do preço unitário. |
unit |
A unidade do denominador. |
ProductDetail
Os detalhes do produto.
Representação JSON |
---|
{ "sectionName": string, "attributeName": string, "attributeValue": string } |
Campos | |
---|---|
section |
O cabeçalho da seção usado para agrupar um conjunto de detalhes do produto. |
attribute |
O nome do detalhe do produto. |
attribute |
O valor do detalhe do produto. |
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".
Representação JSON |
---|
{ "textValue": [ string ], "intValue": [ string ], "floatValue": [ number ], "propertyName": string, "boolValue": boolean, "minValue": number, "maxValue": number, "unitCode": string } |
Campos | |
---|---|
text |
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 |
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 |
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 |
Nome da propriedade. Por exemplo, "Resolução da tela" para um produto de TV. O tamanho máximo da string é de 256 caracteres. |
bool |
Valor booleano da propriedade especificada. Por exemplo, para um produto de TV, "True" ou "False" se a tela for UHD. |
min |
Valor mínimo de ponto flutuante da propriedade. Por exemplo, para um produto de TV 1.00. |
max |
Valor flutuante máximo da propriedade. Por exemplo, para um produto de TV, 100,00. |
unit |
Unidade da propriedade. Por exemplo, "Pixels" para um produto de TV. O tamanho máximo da string é 256B. |
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.
Representação JSON |
---|
{ "certificationAuthority": string, "certificationName": string, "certificationCode": string, "certificationValue": string } |
Campos | |
---|---|
certification |
A autoridade certificadora, por exemplo, "European_Commission". O tamanho máximo é de 2.000 caracteres. |
certification |
O nome da certificação, por exemplo, "EPREL". O tamanho máximo é de 2.000 caracteres. |
certification |
O código de certificação. O tamanho máximo é de 2.000 caracteres. |
certification |
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. |
ProductStructuredTitle
Título estruturado, para títulos gerados por algoritmo (IA).
Representação JSON |
---|
{ "digitalSourceType": string, "content": string } |
Campos | |
---|---|
digital |
O tipo de origem digital, por exemplo, "trained_algorithmic_media". Seguindo IPTC. O tamanho máximo é de 40 caracteres. |
content |
O comprimento máximo do texto do título é de 150 caracteres |
ProductStructuredDescription
Descrição estruturada, para descrições geradas por algoritmos (IA).
Representação JSON |
---|
{ "digitalSourceType": string, "content": string } |
Campos | |
---|---|
digital |
O tipo de origem digital, por exemplo, "trained_algorithmic_media". Seguindo IPTC. O tamanho máximo é de 40 caracteres. |
content |
O comprimento máximo do texto da descrição é de 5.000 caracteres |