Method: accounts.productInputs.insert

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, este método 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.

Solicitação HTTP

POST https://merchantapi.googleapis.com/products/v1beta/{parent=accounts/*}/productInputs:insert

O URL usa a sintaxe de transcodificação gRPC.

Parâmetros de caminho

Parâmetros
parent

string

Obrigatório. A conta em que este produto será inserido. Formato: accounts/{account}

Parâmetros de consulta

Parâmetros
dataSource

string

Obrigatório. O nome da fonte de dados do produto principal ou complementar. Se o produto já existir e a fonte de dados fornecida for diferente, ele será movido para uma nova fonte. Formato: accounts/{account}/dataSources/{datasource}.

Corpo da solicitação

O corpo da solicitação contém uma instância de ProductInput.

Corpo da resposta

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 nas plataformas do Google. As entradas, as regras e os dados de fontes de dados complementares do produto são combinados para criar o [product][google.shopping.content.bundles.Products.Product] processado.

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

Os seguintes atributos são obrigatórios: [feedLabel][google.shopping.content.bundles.Products.feed_label], [contentLanguage][google.shopping.content.bundles.Products.content_language] e [offerId][google.shopping.content.bundles.Products.offer_id].

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 da entrada do produto e das submensagens correspondem ao nome em inglês do atributo correspondente na especificação da indústria, com algumas exceções.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

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}}"
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. 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. Para mais detalhes, consulte a especificação dos dados do produto.
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 outros atributos usados no Comprar com o Google. O número máximo permitido de caracteres para cada atributo personalizado é 10.240 (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 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.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/content

Para mais informações, consulte a Visão geral do OAuth 2.0.