Moderaciones

Contenidos

→Consultar moderaciones
→Consultar moderaciones con filtro
    ↳Filtros disponibles
→Calidad de imágenes
    ↳Cómo identificar errores
    ↳Descripción de parámetros
    ↳Posibles ID de Condiciones
    ↳Manejo de errores
→Agregar tag poor_quality_thumbnail en el ítem de prueba

Consultar moderaciones

A través del GET puedes consultar los elementos afectados por algún tipo de moderación incluyendo:

• ítems
• preguntas o respuestas (questions)
• opinión del producto (review)

Además podrás conocer la razón (reason) y solución (remedy) para aplicar en español/portugués (depende el sitio donde aplica la infracción) o en inglés.
Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_ID

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/12345678

Respuesta:

{
   "infractions": [
       {
           "id": "594794188",
           "date_created": "2020-10-28T01:43:32.414-0400",
           "user_id": "12345678",
           "related_item_id": "MLA1692147078",
           "element_id": "MLA1692147078",
           "element_type": "ITM",
           "site_id": "MLA",
           "reason": "La anulamos porque la categoría en elegiste no corresponde con tu foto de portada o título.",
           "remedy": "Modifica la categoría de tu publicación para que se corresponda con tu título y foto de portada."
       },
       {
           "id": "594651285",
           "date_created": "2020-10-27T22:46:17.631-0400",
           "user_id": "12345678",
           "related_item_id": "MLB1692147078",
           "element_id": "MLA1692147078",
           "element_type": "ITM",
           "site_id": "MLA",
           "reason": "La anulamos porque la categoría en elegiste no corresponde con tu foto de portada o título.",
           "remedy": "Modifica la categoría de tu publicación para que se corresponda con tu título y foto de portada."
       }
   ],
   "paging": {
       "offset": 0,
       "limit": 2,
       "total": 20671
   },
   "sorting_type": "date_created_desc"
}

Campos de la respuesta

id: identificador único de la infracción.
date_created: fecha en que se produjo la infracción.
user_id: el usuario que realizó la infracción.
related_item_id: identificador único de la publicación relacionada con el elemento que posee la infracción. Si la infracción es en una publicación, el valor de este atributo será igual a valor del atributo element_id.
element_id: identificador único del elemento que posee la infracción. Es dependiente del atributo element_type.
element_type: tipo de elemento, los valores pueden ser: ITM (publicación), QUE (preguntas y respuestas) y REV (reviews/opinión de productos).
site_id: sitio del marketplace del elemento que tiene la infracción.
reason: texto (html) que describe el motivo y política que se infraccionó.
remedy: texto (html) que indica la acción, sólo en los casos en que sea recuperable. Por ejemplo, “Quitar los datos personales de una publicación”.

Consultar moderaciones con filtro

Filtros disponibles

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/$USER_ID?date_created_since=AAAA-MM-DD&limit=XX&offset=X

Ejemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/12345678?date_created_since=2020-12-15&limit=1&offset=0

Respuesta:

{
   "infractions": [
       {
           "id": "594794188",
           "date_created": "2020-10-28T01:43:32.414-0400",
           "user_id": "12345678",
           "related_item_id": "MLA169211231",
           "element_id": "MLA169211232",
           "element_type": "ITM",
           "site_id": "MLA",
           "reason": "La anulamos porque la categoría en elegiste no corresponde con tu foto de portada o título.",
           "remedy": "Modifica la categoría de tu publicación para que se corresponda con tu título y foto de portada."
       }],
   "paging": {
       "offset": 0,
       "limit": 1,
       "total": 20671
   },
   "sorting_type": "date_created_desc"
}

Calidad de imágenes

El recurso /quality/picture te permitirá identificar qué errores tienen las imágenes de aquellos ítems que tienen el tag poor_quality_thumbnail, es decir, que fueron validados por Mercado Libre y no cumplen algún requisito de imagen. Así, podrás identificar las publicaciones con imágenes de baja calidad y en consecuencia, que hayan sido moderadas, provocando la pérdida de exposición en los listados de búsquedas.

Conoce más sobre el recurso Búsqueda de ítems y la importancia de las fotos para los vendedores.

Cómo identificar errores

Para identificar si tienes ítems con errores, realiza la siguiente llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/quality/pictures/$ITEM_ID

Respuesta:

{
    "itemID": "MLA0111111",
    "quality": "good",
    "thumbnail": "344725-MLA25503040734_042017",
    "conditions": [
        {
            "id": "white_background",
            "passed": true
        },
        {
            "id": "minimum_size",
            "passed": true
        },
        {
            "id": "logo_text_watermark",
            "passed": true
        },
        {
            "id": "unprofessional_photo",
            "passed": true
        }
    ],
    "taggedDate": "2019-05-02T07:27:40Z"
}

Descripción de parámetros

itemID: ID de la publicación.
quality: calidad de imagen, puede tomar los valores “good” ó “poor”, definiendo los estados de “buena imagen” o “mala imagen” respectivamente.
thumbnail: es la imagen por la cual se procesó el ítem, corresponde a la thumbnail del ítem.
conditions: son un conjunto de condiciones por las que pasa un ítem para determinar su calidad de imagen. Una condición está formada por su ID (dando una definición corta de que analiza) y su atributo de passed, un valor booleano definiendo si la imagen cumplió la condición o no.
taggedDate: fecha del último procesamiento realizado sobre el ítem.

Posibles ID de Condiciones

minimum_size: Esta validación evalúa si alguna de las imágenes de la publicación supera el mínimo de 500 x 500 px.
logo_text_watermark: Esta validación evalúa si la primera imagen de la publicación contiene logos, texto, banners promocionales o marcas de agua.
white_background: Esta validación evalúa si la primera imagen de la publicación tiene fondo blanco puro. Es decir, fondo blanco creado con un editor de imágenes, en lugar de una foto de producto frente a una pared u otro elemento.
multiproduct: Esta validación evalúa si la primera imagen contiene más de un producto. Por ejemplo, no permitimos que la primera imagen de la publicación contenga varios pares de zapatillas.
blur: Esta validación evalúa que las imágenes de la publicación no sean borrosas.
unprofessional_photo: Esta validación se ejecuta cuando el resto de las validaciones da negativo. Evalúa tres condiciones a la vez: multiproducto, fondo blanco y logos. No significa que la imagen cumpla las tres, sino que puede no estar cumpliendo con alguna de las tres.
rollbacked: Esta validación es reservada para el equipo de atención al cliente. La utilizamos cuando un vendedor se contacta para reclamar por detecciones incorrectas (falso positivo). Una vez aplicada, la foto no se vuelve a moderar, excepto que el vendedor cambie la imagen.

Manejo de errores

Estructura del error

{
"error": Error Type,
"code": Error code,
"message": error message,
"cause": list of error cause
}

Ejemplo invalid access_token

{
  "message": "access_token is missing",
  "error": "Forbidden",
  "status": 403,
  "cause": "Couldn't validate authentication"
}

Ejemplo ítem sin validar

{
 "message": "No picture tagged for item (Item_id)",
 "error": "Not Found",
 "status": 404,
 "cause": "Element not found"
}

Para consultar qué acciones debes realizar si la imagen principal de tu publicación no supera alguna validación puedes utilizar el siguiente recurso:

Llamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/tagging/quality/message/$ITEM_ID

Respuesta:

{
  "reason": "Para recuperar tu exposición, corregí tus fotos
Asegurate de que la primera imagen de tu producto tenga como mínimo 500 píxeles en uno de los lados. Te recomendamos usar 1200 x 1200, para que puedan hacer zoom.
",
  "conditions": [
    {
      "id": "sizePictures",
      "message": "Asegurate de que la primera imagen de tu producto tenga como mínimo 500 píxeles en uno de los lados. Te recomendamos usar 1200 x 1200, para que puedan hacer zoom."
    }
  ]
}

Conoce más sobre cómo trabajar con imágenes.

Agregar tag poor_quality_thumbnail en el ítem de prueba

Para añadir el tag "poor_quality_thumbnail" a un ítem de prueba, cargue los datos de su usuario de test en el formulario.