Descripción de artículos
Contenidos
→Consejos para describir una publicación
→Cargar la descripción en un ítem
→¿Cómo publicar?
→Beneficios de utilizar texto plano
→Agrega o reemplaza una descripción existente
→Error al cargar descripción
Consejos para describir una publicación
- Primero carga los datos importantes en la ficha técnica, es decir todas las especificaciones sin olvidar el código universal de producto.
- Verifica que los datos que vas a escribir en la descripción sean los detalles que no están en la ficha técnica.
- Jerarquiza la información para que quede bien organizada. Utiliza mayúsculas, guiones, espaciado, etc.
- Sé breve y realiza una lectura de tu propia descripción para comprobar su longitud.
Puedes consultar todos los detalles sobre cómo describir un producto.
Cargar la descripción en un ítem
A través de la API, podrás trabajar con descripciones que contienen texto plano.
¿Cómo publicar?
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
Beneficios de utilizar texto plano
- Tendrán un mejor resultado en las búsquedas.
- Las descripciones se descargarán 5 veces más rápido.
- Se verán correctamente en todos los dispositivos (móviles, computadoras, tablets).
- Además, podrás cargar hasta 10 fotos del producto y/o un link con un video de Youtube.
A continuación te mostraremos un ejemplo sobre la mejor práctica para a armar la descripción:
Producto: “Raqueta Babolat Pure Control 3” [su_custom_gallery source="media: 10252" limit="1" link="lightbox" width="870" height="890"]
Agrega o reemplaza una descripción existente
Si no enviaste nada en la descripción cuando publicaste un producto, puedes agregarla más tarde. Lo mismo, si deseas modificar la preexistente.
Ejemplo:
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
¿Ves? ¡Es fácil! La descripción se puede agregar o reemplazar cuando desees, aun cuando el artículo ya tenga ofertas; por eso, manos a la obra y prepara una descripción excelente para tus artículos.
Error al cargar descripción
Publicando un producto
En caso que realices un POST a ítems creando una publicación con una descripción que contenga algún carácter no aceptado, la respuesta contendrá más información acerca del error, como la posición del carácter equivocado.
Ejemplo:
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
En la respuesta puedes identificar que los errores se encuentran en la posición 6 y 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"
}
]
}
Agregando o modificando una descripción 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 la respuesta devuelva la posición del carácter que genera error, debes agregar el parámetro api_version=2.
El error será así:
{
"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"
}
]
}
En el nodo references puedes obtener la ubicación exacta del caracter que genera el error. En este caso 0 y 5.