Moderações

Foi desenvolvida uma API que permite ao integrador consultar os elementos que estão com alguma moderação, ou seja, que não passou em algum dos filtros da plataforma. Por exemplo, anúncios que por algum motivo ficaram pendentes para revisão por motivo de preço, descrição, etc., ou questões que tiveram algum conteúdo que não passou no filtro. Dessa forma o integrador poderá ter acesso a algumas situações que só eram exibidas na plataforma para o vendedor.

Conteúdos

→Consultar moderações
→Consultar moderações com filtro
→Considerações
→Relação dos status
→Qualidade de imagens
    ↳Como identificar erros
    ↳Descrição de parâmetros
    ↳Possíveis IDs de Condições
    ↳Gerenciamento de erros


Consultar moderações

Através do GET é possível consultar os elementos que estão com alguma moderação.


Chamada:

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

Exemplo:

curl -X GET https://api.mercadolibre.com/moderations/infractions/305860144?access_token=$ACCESS_TOKEN
Nota:
Considere que a API /moderations/infractions/ listará os itens com status final (forbidden) ou temporário (waiting_for_patch, held, pending_documentation), mas não trará itens que foram baixados por duplicidade. Se você deseja verificar se um usuário está suspenso, pode verificar o status => list => allow através dos usuários (https://api.mercadolibre.com/users/$USER_ID). Se esse campo for false, significa que está suspenso.
Importante:
Caso o usuário se encontre suspenso, sempre recomendamos a que busque o portal de contato ou em alguns caso ao tentar logar-se retornará um ponto de contato.


Consultar moderações com filtro

É possível realizar a mesma consulta com alguns filtros, como: ano e limite de registros a serem retornados na API.


Chamada:

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

Exemplo:

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

Resposta:

{
    "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"
            ]
        }
    ]
}


Considerações

limit: límite para o paginado (Default = 20, <= 50)
offset: offset para o paginado (Default = 0, <=50)
year_month: ano e mês desde quando quer obter as infrações (Exemplo: 201711 (Año y Mes)


Relação dos status

  • element_type: tipo de elemento

- ITM (item): significa que o elemento é um anuncio
-QUE (questão/resposta): o elemento pode ser uma pergunta ou resposta no anúncio.

  • type: tipo de infracción.

- Neste momento só será retornada o tipo "infraction".

  • current_status: estado do elemento atualmente.

- os possíveis status que podem ser retornados são: under_review, paused, active.

  • sub_status: listado de sub estados do elemento atualmente. O substatus pode retornar vazio e também pode retornar.

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

- Current status paused: freezes, suspended.


Qualidade de imagens

O recurso /quality/picture permitirá a você identificar quais erros as imagens desses itens que possuem a tag poor_quality_thumbnail possuem, ou seja, foram validadas pelo Mercado Livre e não atendem a nenhum requisito de imagem. Assim, você poderá identificar as publicações com imagens de baixa qualidade e, conseqüentemente, moderadas, causando perda de exposição nas buscas.
Saiba mais sobre o recurso Busca de itens e a importância das fotos para os vendedores.


Como identificar erros

Para identificar se há itens com erros, realize a seguinte chamada:

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

Resposta:

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

Descrição de parâmetros

itemID: ID do anúncio.
quality: qualidade de imagem, você pode tomar os valores “good” ou “poor”, definindo os status de “imagem boa” ou “imagem ruim” respectivamente.
thumbnail: é a imagem pela qual o item foi processado, corresponde ao thumbnail do item.
conditions: são um conjunto de condições pelas quais um item atravessa para determinar sua qualidade de imagem. Uma condição é composta por sua ID (dando uma definição breve do que analisa) e seu atributo de passed, valor booleano definindo se a imagem atendeu ou não à condição.
taggedDate: data do último processamento realizado sobre o item.


Possíveis IDs de Condições

minimum_size: Esta validação avalia se alguma das imagens da publicação superam o mínimo de 500 x 500 px.
logo_text_watermark: Esta validação avalia se a primeira imagem da publicação contém logos, texto, banners promocionais ou marcas d'água.
white_background: Essa validação avalia se a primeira imagem da publicação tem fundo branco puro. Ou seja, um fundo branco criado com um editor de imagens, ao invés de uma foto do produto em frente a uma parede ou outro elemento.
multiproduct: Avalia se a primeira imagem contém mais de um produto. Por exemplo, não permitimos que a primeira imagem da publicação tenha vários pares de sapatilha.
blur: avalia se as imagens da publicação não estejam borradas.
unprofessional_photo: ocorre quanto o resto das validações da negativo e avalia três condições: mais de um produto, fundo branco e logos. Não significa que a imagem cumpra as três, mas que pode não estar cumprindo uma delas.
rollbacked: esta validação é reservada a equipe de atenção ao cliente. Utilizada quando o vendedor se contacta para reclamar de detecções incorretas (falso positivo). Uma vez aplicada, a foto não será moderada, exceto que o vendedor altere a imagem.


Gerenciamento de erros

Estrutura do erro

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

Exemplo invalid access_token

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

Exemplo item sem validar

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

Para consultar quais ações deve realizar caso a imagem principal do seu anúncio não atenda a alguma validação, você pode utilizar o seguinte recurso:

Chamada:

curl -X GET https://api.mercadolibre.com/tagging/quality/message/$ITEM_ID

Resposta:

{
  "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." } ] }
Nota:
Quando você corrige a imagem de uma publicação que foi moderada, as validações serão realizadas novamente e, se forem positivas, a tag será removida e recuperará sua exposição original.

Veja mais sobre trabalhar com imagens.