Descrição de produtos
Conteúdos
→Conselhos para descrever um anuncio
→Carregar a descrição em um item
→Como realizar uma publicação?
→Benefícios de utilizar texto sem formato
→Adicionar ou substituir uma descrição existente
→Erro ao carregar a descrição
Conselhos para descrever um anuncio
- Primeiro carregue os dados importantes na ficha técnica, todas as especificações sem esquecer o código universal do produto.
- Verifique que os dados que que estarão na descrição não estejam na ficha técnica.
- Hierarquize a informação para que esteja bem organizada. Utilize maiúsculas, hífen, espaços, etc.
- Seja breve e realize uma leitura da própria descrição para comprovar a longitude.
Você pode verificar todos os detalhes sobre como descrever um produto.
Carregar a descrição em um item
A través de la API, podrás trabajar con descripciones que contienen texto simple.
Como realizar uma publicação?
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"title": "Item de test - No Ofertar",
"category_id": "MLA47392",
"price": 10,
"currency_id": "ARS",
"available_quantity": 1,
"buying_mode": "buy_it_now",
"listing_type_id": "gold_special",
"condition": "new",
"description":{
"plain_text":"Descripción con Texto Plano \n"},
"video_id": "YOUTUBE_ID_HERE",
"tags": [
"immediate_payment"
],
"warranty": "12 months by Ray Ban",
"pictures": [
{
"source": "https://upload.wikimedia.org/wikipedia/commons/f/fd/Ray_Ban_Original_Wayfarer.jpg"
},
{
"source": "https://en.wikipedia.org/wiki/File:Teashades.gif"
}
]
}'
https://api.mercadolibre.com/items
Benefícios de utilizar texto sem formato
- Terão um melhor resultado nas pesquisas.
- As descrições serão descarregadas 5 vezes mais rápido.
- Serão visualizadas em todos os dispositivos (móveis, tablets, computadores).
- Além disso, você poderá carregar até 10 imagens do produto e/ou um link com um vídeo do Youtube.
A seguir apresentamos um exemplo sobre a melhor prática para criar a descrição:
Produto: “Raquete Babolat Pure Control 3” [su_custom_gallery source="media: 10396" limit="1" link="lightbox" width="870" height="890"]
Adicionar ou substituir uma descrição existente
Se você não forneceu uma descrição ao publicar um produto, poderá adicioná-la mais tarde. O mesmo acontece se você desejar modificar a existente.
Exemplo:
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"plain_text":"Los mejores Rayban Wayfarer. Test."
}'
https://api.mercadolibre.com/items/$ITEM_ID/description?api_version=2
Você percebe como é fácil? A descrição pode ser adicionada ou substituída quando você quiser, mesmo quando o artigo já tenha ofertas; por isso, mãos à obra, crie uma descrição para seus artigos.
Erro ao carregar a descrição
Publicando um produto
No caso de você faça um POST ao itens criando uma publicação com uma descrição que contenha algum caractere inaceitável, a resposta conterá mais informações sobre o erro, como a posição do caractere errado.
Exemplo:
curl -X POST -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"title":"Item de testeo",
"category_id":"MLA47781",
"price":10.01,
"currency_id":"ARS",
"available_quantity":1,
"buying_mode":"buy_it_now",
"listing_type_id":"gold_special",
"condition":"new",
"description":{
"plain_text":"Texto < br > 😃"
},
"pictures":[
{
"source":"https://http2.mlstatic.com/item-de-testeo-por-favor-no-ofertar-kcoff-D_NQ_NP_521015-MCO25103941466_102016-F.jpg"
}
]
}
https://api.mercadolibre.com/items
Na resposta, você pode identificar que os erros estão nas posições 6 e 16:
{
"message": "Validation error",
"error": "validation_error",
"status": 400,
"cause": [
{
"department": "items",
"cause_id": 398,
"type": "error",
"code": "item.description.type.invalid",
"references": [
"plain_text[6]",
"plain_text[16]"
],
"message": "The description must be in plain text"
}
]
}
Adicionando ou modificando uma descrição existente
curl -X PUT -H 'Authorization: Bearer $ACCESS_TOKEN' -H "Content-Type: application/json" -d
'{
"plain_text':'< br >,😃"
}'
https://api.mercadolibre.com/items/$ITEM_ID/description?api_version=2
Para que a resposta retorne a posição do caractere que gera o erro, você deve adicionar o parâmetro api_version=2.
O erro será assim:
{
"message": "Validation error",
"error": "validation_error",
"status": 400,
"cause": [
{
"department": "items",
"cause_id": 398,
"type": "error",
"code": "item.description.type.invalid",
"references": [
"plain_text[0]",
"plain_text[5]"
],
"message": "The description must be in plain text"
}
]
}
No nó de referências, você pode obter a localização exata do caractere que gera o erro. Nesse caso, 0 e 5.