- Solicitação HTTP
- Parâmetros de caminho
- Parâmetros de consulta
- Corpo da solicitação
- Corpo da resposta
- Escopos de autorização
- Faça um teste
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, esse 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 |
Obrigatório. A conta em que este produto será inserido. Formato: accounts/{account} |
Parâmetros de consulta
Parâmetros | |
---|---|
dataSource |
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: |
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 ( |
Campos | |
---|---|
name |
Identificador. O nome da entrada do produto. Formato: |
product |
Apenas saída. O nome do produto processado. Formato: |
channel |
Obrigatório. Imutável. O canal do produto. |
offerId |
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 |
Obrigatório. Imutável. O código de idioma ISO 639-1 de duas letras do produto. |
feedLabel |
Obrigatório. Imutável. O rótulo do feed do produto. |
attributes |
Opcional. Uma lista de atributos do produto. |
customAttributes[] |
Opcional. Uma lista de atributos personalizados (fornecidos pelo comerciante). Ele também pode ser usado para enviar qualquer atributo da especificação de dados no formato genérico (por exemplo, |
versionNumber |
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 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.