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: condição que determina se a imagem supera o tamanho mínimo de 500 x 500 px.
text_logo_watermark: são detectados logos, texto, banners ou marcas d'água na imagem.
white_background: não detecta fundo branco na imagem.
multiproduct: detecta mais de um produto na imagem.
blur: detector de imagem embaçada.
unprofessional_photo: detector de qualidade geral de uma imagem. Falha nos casos em que é detectado que uma imagem não atende a alguma das condições mencionadas acima.
rollbacked: item rollbackeado por prustomer.


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.