REST Resource: accounts.productInputs

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

Representação JSON 
{
  "name": string,
  "product": string,
  "channel": enum (ChannelEnum),
  "offerId": string,
  "contentLanguage": string,
  "feedLabel": string,
  "attributes": {
    object (Attributes)
  },
  "customAttributes": [
    {
      object (CustomAttribute)
    }
  ],
  "versionNumber": string
}
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~idioma_do_conteúdo~rótulo_do_feed~id_da_oferta. Por exemplo, o nome da entrada de produto é "contas/123/entradas_de_produto/on-line~pt-BR~US~sku123".
product

string

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

enum (ChannelEnum)

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

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

string

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

string

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

object (Attributes)

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

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

string (int64 format)

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

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

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

Métodos

delete

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

insert

 Faz upload de uma entrada de produto na sua conta do Merchant Center.