Gerenciar moderações

Filtrar itens com infrações

Para obter itens com moderação você pode consultar aquelas com status under_review, e sub-estado: warning, waiting_for_patch, held, pending_documentation, forbidden, picture_dowloading_pending filtrando mediante o status "pending".

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/$USER_ID/items/search?status=pending

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/users/123456/items/search?status=pending

Resposta:

{
  "seller_id": "123456",
  "query": null,
  "paging": {
      "limit": 50,
      "offset": 0,
      "total": 8
  },
  "results": [
      "MLC951993111",
      "MLC951803222",
      "MLC949619333",
      "MLC949606444",
      "MLC947744555",
      "MLC947725666",
      "MLC947725777",
      "MLC947699888"
  ],
  "orders": [...]
}

Status, substatus e tags de moderações

Conheça mais sobre o fluxo e estado das publicações.

Consultar moderações de um usuário

Com a seguinte consulta, você pode ver as moderações com estados finais (forbidden) e temporais (waiting_for_patch, held, pending_documentation). Não verá os itens baixados por duplicados. Recomendamos que identifique o motivo (reason) e solução (remedy), e garanta acionáveis para os vendedores conforme o tipo de moderação recebida.

Parâmetros opcionais

Permitirão filtrar as moderações de um usuário, conforme:

• related_item_id: ID da publicação associada à infração.
• element_id: ID do elemento moderado.
• element_type: tipo de elemento moderado. ITM (item), REV (review), QUE (pergunta/resposta).
• date_created_since: data de início do filtrado. Formato: YYYY-MM-DD
• date_created_to: data de fim do filtrado. Formato: YYYY-MM-DD
• language: pode solicitar os textos do reason e remedy em idioma espanhol ou português. O idioma por default é inglês. ES (espanhol) ou PT (português).
• limit: quantidade de infrações devolvidas. O valor é de 1 a 20. Por default 20.
• offset: offset para o paginado.
• sort: ordenar os resultados por data de criação de maneira ascendente ou descendente. Exemplo date_created_asc, date_created_desc.

Chamada:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/288230000?date_created_since=2023-09-01&limit=2

Exemplo:

curl -X GET -H 'Authorization: Bearer $ACCESS_TOKEN' https://api.mercadolibre.com/moderations/infractions/288230000?date_created_since=2023-09-01&limit=2

Resposta:

{
  "infractions": [
      {
          "id": "1378710000",
          "date_created": "2023-09-11T10:37:45.107-0400",
          "user_id": "288230000",
          "related_item_id": "MLA135230000",
          "element_id": "MLA13520000",
          "element_type": "ITM",
          "site_id": "MLA",
          "filter_subgroup": "DESC",
          "reason": "La pausamos porque detectamos un cambio inusual en su precio. Verifica el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos.",
          "remedy": "Inactiva para revisar
La pausamos porque detectamos un cambio inusual en su precio. Verificá el valor antes de reactivarla. Una vez que lo hagas, quedará activa en unos minutos."
      },
      {
          "id": "1366077111",
          "date_created": "2023-09-03T13:02:14.109-0400",
          "user_id": "288230000",
          "related_item_id": "MLA13862111",
          "element_id": "MLA138621111",
          "element_type": "ITM",
          "site_id": "MLA",
          "filter_subgroup": "PQT",
          "reason": "Tu foto de portada no tiene fondo blanco puro. Corrígelo para reactivar tu publicación.",
          "remedy": "Tu foto de portada aún tiene problemas, corrígela para reactivar tu publicación.
El fondo de esta foto debe ser blanco puro, ¡no uses texturas o elementos de fondo!"
      }
  ],
  "paging": {
      "offset": 0,
      "limit": 2,
      "total": 3
  },
  "sorting_type": "date_created_desc"
}

Campos da resposta

• id: identificador único da infração.
• date_created: data em que foi produzida a infração.
• user_id: o usuário que realizou a infração.
• related_item_id: identificador único da publicação relacionada com o elemento que possui a infração. Se a infração é em uma publicação, o valor deste atributo será igual ao valor do atributo element_id.
• element_id: identificador único do elemento que possui a infração. É dependente do atributo element_type.
• element_type: tipo de elemento, os valores podem ser: ITM (publicação), QUE (perguntas e respostas) e REV (reviews de produtos).
• subgroup: este campo te permite identificar, agrupar e resumir (sumarizar) as infrações pertencentes a distintos grupos de filtros.

• reason: texto (html) que descreve o motivo e política que se infringiu.
• remedy: texto (html) que indica a ação, apenas em casos recuperáveis.

Moderações para VIS

A tabela seguinte lista as possíveis moderações aplicáveis às diferentes unidades de negócio relacionadas com veículos e imóveis (VIS), como também as ações possíveis e algumas recomendações para corrigir a moderação:

Próxima: Moderações com pausa.