REST Resource: accounts.products

Recurso: product

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 vários 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.

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}}", 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

enum (ChannelEnum)

Apenas saída. O canal do produto.
offerId

string

Apenas saída. Seu identificador exclusivo do produto. Isso é igual 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.
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). 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.
productStatus

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

string (int64 format)

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

Somente com suporte 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.

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)

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)

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

DestinationStatus

O status de destino do produto.

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

enum (ReportingContextEnum)

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

string

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

string

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

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.

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

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.

Métodos

get

 Recupera o produto processado da sua conta do Merchant Center.

list

 Lista os produtos processados na sua conta do Merchant Center.