Trabalho com imagens

Ao publicar um produto, as imagens são opcionais, mas certamente elas fazem uma grande diferença em relação à qualidade, e aumentarão suas chances de venda atraindo mais visitantes para seus produtos. Ao publicar um produto novo, você poderá adicionar imagens. Este tutorial mostra como fazer upload das imagens de nossos servidores para adicioná-las a seus produtos.

Assuntos

Considerações e práticas recomendadas

As imagens RGB são muito mais recomendáveis do que as CMYK.
Há um número máximo de imagens por produto dependendo das categorias.
Você pode fazer upload de até 10 MB nos seguintes formatos:

  • JPG
  • JPEG
  • PNG
  • GIF não animadas

Zoom
Caso você tenha imagens com uma largura maior que 800 pixeis, um widget de zoom é ativado para que, quando os compradores passarem o mouse sobre a imagem, eles possam visualizá-la em primeiro plano. Isso é altamente recomendado para roupas e imóveis.

Como fazer upload de uma imagem

Agora é a hora de fazer upload de seu primeiro arquivo de imagem para que ele seja salvo em nossos servidores. É muito fácil. Basta colocar o caminho exato onde a imagem foi salva:

curl -F file=@/home/user/picture.jpg

https://api.mercadolibre.com/pictures?access_token=$ACCESS_TOKEN

Como resposta, você receberá um JSON com a descrição dos detalhes da imagem.
Lembre-se de salvar o ID da imagem. Os demais campos representam os diversos tamanhos das imagens.

{
   "id":"MLA430387888_032012",
   "quality":"",
   "variations":[...]
}

Vinculação de uma imagem a seu produto

Com o picture_id que obteve antes, você pode vincular a imagem a seu produto, conforme mostrado abaixo:

curl -X POST -H "Content-Type: application/json" -H "Accept: application/json" -d
'{"id":"MLA430387888_032012"}'

https://api.mercadolibre.com/items/MLA421101451/pictures?access_token=$ACCESS_TOKEN

Pronto! Agora vá para a página de descrição de seu produto (usando o campo permalink) e veja como sua imagem é exibida.

Substituição de imagens

Se for necessário substituir as imagens atuais de seu produto, você deverá realizar uma solicitação PUT incluindo o ID do produto e a URL da imagem, junto com seu access_token, conforme o exemplo abaixo:

curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
'{
  "pictures":[
    {"source":"http://www.apertura.com/export/sites/revistaap/img/Tecnologia/Logo_ML_NUEVO.jpg_33442984.jpg"},
    {"source":"http://appsuser.net/www/wp-content/uploads/2012/10/logo-mercadolibre.jpg"}
  ]
}' https://api.mercadolibre.com/items/{item_id}?access_token=$ACCESS_TOKEN

Para você levar em conta!

  • Se você quiser substituir uma imagem, deverá criar um novo source (dar outro nome à imagem); caso contrário, ao reutilizar o mesmo nome com conteúdo diferente, a imagem não será atualizada.
  • Se você tiver um grupo de imagens e quiser realizar as ações a seguir:
    Adicionar uma imagem: deverá enviar as IDs das imagens carregadas que quiser conservar mais os source (URL) das novas imagens. Além disso, você pode alterar a ordem enviando o body do PUT com a forma em que quiser visualizá-las.

    curl -X PUT -H "Content-Type: application/json" -H "Accept: application/json" -d
    '{
    "pictures": [{"source": "http://SOURCE_IMAGEN_NUEVA.jpg"},
    			{"id": "111111 - IMAGEN_EXISTENTE_111111"},
    			{"id": "111111 - IMAGEN_EXISTENTE_111111"},
    			{"id": "111111 - IMAGEN_EXISTENTE_111111"}
    ],
    
    "variations": [{
    "id": "16787985187",
    "picture_ids": [
    		"http://SOURCE_IMAGEN_NUEVA.jpg", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111"]},
    {
    "id": "16787985190",
    "picture_ids": [
    		"http://SOURCE_IMAGEN_NUEVA.jpg", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111"]},
    
    {
    "id": "16787985193",
    "picture_ids": [
    		"http://SOURCE_IMAGEN_NUEVA.jpg", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111", 
            "111111 - IMAGEN_EXISTENTE_111111"]}]
    }' http://api.mercadolibre.com/items/ITEM_ID?access_token=ACCESS_TOKEN

    Remover imagem: deverá enviar somente as IDs das imagens carregadas que você quiser conservar.



Excelente! Agora, a nova imagem de seu produto será exibida. Você já sabe como adicionar e substituir imagens. E lembre-se: boas imagens atrairão mais compradores!



Próximo:
Validador de publicações.

Qualifique entre 1 e 5