Moderaciones

Hemos habilitado un nuevo recurso que te permitirá consultar las publicaciones afectadas por algún tipo de moderación, es decir que no pasaron alguno de los filtros de la plataforma. Por ejemplo, publicaciones que, por algún motivo, quedaron pendientes de revisión debido al precio, descripción, etc., o preguntas que incluyan algún contenido que no supere el filtro. De esta forma, el integrador podrá acceder a algunas situaciones que sólo serán visualizadas en la plataforma por el vendedor.

Contenidos

→Consultar moderaciones
→Consultar moderaciones con filtro
→Consideraciones
→Listado de estados
→Calidad de imágenes
    ↳Cómo identificar errores
    ↳Descripción de parámetros
    ↳Posibles ID de Condiciones
    ↳Manejo de errores


Consultar moderaciones

A través del GET se pueden consultar los elementos afectados por algún tipo de moderación.
Llamada:

curl -X GET https://api.mercadolibre.com/moderations/infractions/$USER_ID?access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/moderations/infractions/305860144?access_token=$ACCESS_TOKEN
Nota:
Ten en cuenta que en la respuesta no se verán los ítems dados de baja por duplicados y solo aparecen los ítems en el cual los estados pueden ser finales (forbidden) o temporales (waiting_for_patch, held, pending_documentation). Si quieres consultar si un usuario está suspendido puedes hacerlo a través de users (https://api.mercadolibre.com/users/$USER_ID) y chequear el campo status => list => allow. En caso que sea false ese campo, significa que está suspendido.
Importante:
En caso de que el usuario esté suspendido, deberá consultar la configuración de su cuenta en el portal de Ayuda.


Consultar moderaciones con filtro

Se puede realizar la misma consulta con algunos filtros, tales como: año y límite de registros que serán exhibidos por la API.


Llamada:

curl -X GET https://api.mercadolibre.com/moderations/infractions/$USER_ID?year_month=201711&limit=50&offset=0&access_token=$ACCESS_TOKEN

Ejemplo:

curl -X GET https://api.mercadolibre.com/moderations/infractions/305860144?year_month=201711&limit=50&offset=0&access_token=$ACCESS_TOKEN

Respuesta:

{
    "message": "1 items with infractions since December 2017",
    "seller": {
        "id": 305860144,
        "nickname": "TESTDD9J81ZY"
    },
    "paging": {
        "limit": 20,
        "offset": 0,
        "total": 1
    },
    "results": [
        {
            "element_id": "MLB997546581",
            "element_type": "ITM",
            "infraction_date": "2018-03-21T09:59:30.480-04:00",
            "type": "infraction",
            "reason": "Mal categorizado - Categoría - Titulo",
            "current_status": "under_review",
            "sub_status": [
                "waiting_for_patch"
            ]
        }
    ]
}


Consideraciones

limit: límite para el paginado (Default = 20, <= 50)
offset: offset para el paginado (Default = 0, <=50)
year_month: año y mes desde cuando se quiere obtener infracciones (Ejemplo: 201711 (Año y Mes)


Listado de estados

  • element_type: tipo de elemento

- ITM (item): significa que el elemento es un anuncio.
-QUE (pregunta/respuesta): el elemento puede ser una pregunta o respuesta en el anuncio.

  • type: tipo de infracción.

- En este momento sólo se mostrará el tipo "infraction".

  • current_status: estado del elemento actualmente.

- Los posibles estados que pueden mostrarse son: under_review, paused, active.

  • sub_status: listado de sub estados del elemento actualmente. El subestado puede mostrarse vacío y también puede exhibirse.

-Current status under_review: waiting_for_patch, suspended, held, banned, pending_documentation, forbidden, suspended_for_prevention.

- Current status paused: freezes, suspended.


Calidad de imágenes

El recurso /quality/pictures te permitirá identificar los motivos por los cuales el ítem está perdiendo exposición en los listados, es decir, no cumple con los requisitos de imágenes. A continuación, te explicamos cómo identificar si un ítem está siendo moderado o tiene problemas con sus imágenes.

Además, con el recurso /items puedes ver aquellos ítems que están perdiendo exposición siempre que cuenten con el tag de "good_quality_thumbnail" o “poor_quality_thumbnail”. Conoce más en nuestra guía de Items y búsquedas.


Cómo identificar errores

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

curl -X GET https://api.mercadolibre.com/quality/pictures/$ITEM_ID?access_token=$ACCESS_TOKEN

Respuesta:

{
    "itemID": "MLA0111111",
    "quality": "good",
    "thumbnail": "344725-MLA25503040734_042017",
    "conditions": [
        {
            "id": "white_background",
            "passed": true
        },
        {
            "id": "minimum_size",
            "passed": true
        },
        {
            "id": "text_logo_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: evalúa si alguna de las imágenes de la publicación supera el mínimo de 500 x 500 px.
text_logo_watermark: evalúa si la primera imagen de la publicación contiene logos, texto, banners promocionales o marcas de agua.
white_background: 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: 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: evalúa que las imágenes de la publicación no sean borrosas.
unprofessional_photo: se ejecuta cuando el resto de las validaciones da negativo y 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 no taggeado con thumbnail 

{
 "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 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.