Sincronização de publicações

Assim que você tiver publicações ativas em nosso site, é provável que você tenha de fazer atualizações e alterações periodicamente para excluir anúncios já vendidos, pausar publicações, melhorar descrições, atualizar preços etc.
Leia o guia a seguir e saiba como fazer isso:

Assuntos

Considerações

Você pode alterar valores para:

  • Title
  • Price
  • Video
  • Pictures
  • Description
  • Location
  • Atributos da publicação (array “attributes”)

Você também deve lembrar que:

  • A categoria não pode ser alterada através da API.
  • O tipo de publicação só pode ser alterado uma vez.

Atualização de seu anúncio

Vejamos um exemplo básico de atualização do título e do preço de um anúncio. Você só precisará do item_id do produto publicado e do access_token do vendedor.
Exemplo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "title": "Your new title",
  "price": 1000
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Pronto. O título e o preço de seu anúncio foram atualizados, e você deverá receber um status de resposta com código 200 OK para confirmar que não houve inconvenientes.
Lembre de que pode demorar um pouco até que as informações atualizadas fiquem visíveis.

Descrições

Atualizar uma descrição é muito simples. No entanto, como há algumas considerações que você deve lembrar ao adicionar ou substituir descrições, leia o artigo consulte o nosso artigo sobre descrições para ter certeza de que entendeu.

Imagens

Você sempre pode adicionar ou substituir imagens dos anúncios. Leia consulte o nosso tutorial Trabalhar com imagens para saber qual a melhor maneira de fazer isso.

Tipos de publicação

Caso você queira dar mais exposição a seu anúncio, você deve atualizar o tipo de publicação. Conheça os detalhes e as considerações, e aprenda a fazer uma atualização em nosso tutorial Tipos de publicações e upgrades.

Mudança de status das publicações

Qualquer anúncio publicado em nosso site pode ter diferentes status; a seguir, analise a descrição de cada um deles:

  • encerrado: finaliza sua publicação. Uma vez encerrada, a publicação não poderá ser ativada novamente, mas pode ser publicada novamente.
  • pausado: pausa sua publicação. Uma vez pausado, os visitantes não poderão entrar em contato com você, pois os dados de contato de do anúncio são removidos.
  • ativo: reativa um produto previamente pausado.

Se você precisar fazer alterações no status do anúncio, deverá enviar um desses valores para o campo “status”. Lembre de que o valor diferencia entre letras maiúsculas e minúsculas e deve ser enviado em letras minúsculas.

Para pausar um produto ativo, veja o exemplo a seguir:
Exemplo:

 curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
  "status":"paused"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Excelente! Seu anúncio já foi pausado. Agora você já pode tentar reativá-lo fazendo exatamente a mesma chamada, mas enviando “ativo” em vez de “pausado” como valor de status.

Se seu anúncio está encerrado, e você quer publicá-lo novamente, consulte artigo sobre como publicar novamente para fazer isso rapidamente.
Para obter mais informações sobre o status do produto , consulte o artigo sobre ciclo de vida das publicações.

Exclusão de publicações

Depois de excluir uma publicação, não há como reverter. Por isso, tenha cuidado ao fazer isso. Lembre-se sempre de excluir anúncios que já foram vendidos, pois eles concorrem com seus outros anúncios que estão ativos.

Exemplo:
Primeiro passo

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"status": "closed"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Segundo passo

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
{
"deleted":"true"
}
https://api.mercadolibre.com/items/ITEM_ID?access_token=YOUR_ACCESS_TOKEN

Notas:

  • Se ao fazer o segundo PUT você obtiver o erro:
  • message: item optimistic locking
    error: conflict
    status: 409
    cause: array(0)
    Deverá esperar alguns segundos até a informação se atualizar.

  • Eliminado o anúncio, ele continuará sendo visualizado na VIP durante um breve período com a legenda “anúncio finalizado”.

Pronto! Seu produto será excluído.


Próximo:
Gerenciamento de contatos.

Qualifique entre 1 e 5