Actualizar descripción del anuncio en Mercado Livre, con una API
Reemplaza la descripción de un anuncio que ya tiene una.
- Identificador
- mercado_livre_update_item_description
La llamada
POST https://connect.reportei.com/api/tools/mercado_livre_update_item_description/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"item_id": "<item_id>",
"plain_text": "<plain_text>"
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| item_id | string | Sí | Id of the listing, from Search items. |
| plain_text | string | Sí | The new description as plain text, without HTML or emoji. Line breaks as \n. |
Conexiones posibles
Tu cliente conecta su cuenta de Mercado Livre una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
OAuth con la app de tu producto
Registras la app OAuth de tu producto una sola vez, con POST /api/merchants/credentials/mercado_livre, y tu cliente autoriza la cuenta en una pantalla de consentimiento. Connect renueva el token cuando está por vencer.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/mercado_livre_update_item_description. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de Mercado Livre
- Obtener usuario actualGETDevuelve la cuenta de vendedor conectada: id, nickname, email, site_id y reputación del vendedor. El id es el user_id, seller y seller_id de las demás herramientas, y el site_id (MLB en Brasil) va en Buscar categorías.
- Buscar anunciosGETLista los ids de los anuncios del vendedor, 50 por página por defecto. results tiene solo ids de anuncios: Listar anuncios devuelve sus detalles. Pagina con offset y limit; pasados 1000 resultados usa search_type scan y el scroll_id de cada respuesta.
- Listar anunciosGETDevuelve hasta 20 anuncios por id en una llamada: título, precio, available_quantity, sold_quantity, status, permalink, imágenes y atributos. Cada elemento tiene status_code, id y el anuncio en body.
- Buscar categoríasGETPredice la categoría de un producto a partir del título, con el dominio y los atributos reconocidos en el texto. El primer resultado es el más probable. Su category_id va en Crear anuncio y en Listar atributos de la categoría.
- Listar atributos de la categoríaGETLista los atributos de una categoría con id, value_type, valores aceptados y tags. Los atributos con la tag required deben enviarse en Crear anuncio, y los new_required cuando el ítem es nuevo.
- Crear anuncioPOSTPublica un anuncio y lo devuelve con su id. En el modelo User Products, activo para todos los vendedores, envía family_name y ningún title: Mercado Livre arma el título. La descripción se agrega después con Crear descripción del anuncio.
- Actualizar anuncioPUTCambia un anuncio y lo devuelve. Solo cambian los campos enviados. status paused lo oculta, active lo reactiva y closed lo termina para siempre. title y family_name solo cambian mientras el anuncio no tiene ventas.
- Obtener descripción del anuncioGETDevuelve la descripción de un anuncio en plain_text, con date_created y last_updated.
Mira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
