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:
Tenha em conta que na resposta não obterá os itens gravados em duplicado e apenas os itens nos quais os estados podem ser finais (forbidden) ou temporários (waiting_for_patch, held, pending_documentation). 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/pictures permitirá a você identificar os motivos pelos quais o item está perdendo exposição nas listas, isto é, não atende aos requisitos de imagens. A seguir, vamos explicar como identificar se um item está sendo moderado ou tem problemas com suas imagens.

Além disso, com o recurso /itens, você pode ver aqueles itens que estão perdendo exposição desde que eles contem com a tag "good_quality_thumbnail" o “poor_quality_thumbnail”. Saiba mais no nosso manual de Itens e pesquisas.


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": "text_logo_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: avalia se as imagens da aplicação superam o mínimo de 500 x 500 px.
text_logo_watermark: avalia se a primeira imagem da publicação contem logos, texto, banners promocionais ou marcas d'agua.
white_background: avalia se a primeira imagem da publicação tem fundo branco puro, ou seja, fundo branco criado por um editor de imagens, ao invés de uma foto do produto em frente a uma parede branca ou algo parecido.
multiproduct: avalia se a primeira imagem contem 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 não taggeado com thumbnail

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

Veja mais sobre trabalhar com imagens.