v1Recursos/Duplicate Listings/postResolver listagens duplicadas

Resolver listagens duplicadas

Marca listagens duplicadas para remoção, ou as descarta, seja por uma lista explícita de duplicateListingIds ou por um filtro com o mesmo formato da fila do resumo. O modo de filtro é executado como uma única atualização em lote restrita à intersecção dos próprios status do filtro e dos status de origem elegíveis da ação — ele nunca pode alcançar linhas fora do que esse filtro mostraria. Marcar não remove a listagem em si; enfileira o pedido de remoção, que um job em segundo plano executa junto ao publisher.

post/api/v1/listings/duplicates/resolve

listings:write

Corpo da solicitação

actionstring (flag | dismiss)obrigatório

flag (solicitar remoção do publisher) ou dismiss (marcar como não sendo uma duplicata).

duplicateListingIdsarray of stringopcional

IDs explícitos a resolver, até 1000. Mutuamente exclusivo com filter.

filterobjectopcional

Resolve toda linha elegível que corresponda a este filtro em vez de nomear ids explicitamente. Uma chave limitada a clientes específicos também deve passar clientId ao usar o modo de filtro.

filterstring (potential | flagged | deleted | failed)opcional

Restringe a um status: potential, flagged, deleted ou failed.

bandstring (high | med | low)opcional

Restringe a uma faixa de confiança: high, med ou low.

publisherSiteIdintegeropcional

Restringe a um publisher, pelo seu site id numérico.

locationIdstringopcional

Restringe a um local.

searchstringopcional

Busca de texto livre no nome do negócio, endereço e telefone.

clientIdstringopcional

Obrigatório quando sua chave está limitada a clientes específicos e você está usando o modo de filtro (o modo por id é autolimitado por id e não precisa disso).

Resposta

dataobjectopcional

updatednumberopcional

Número de listagens duplicadas que transicionaram para o novo status.

skippedarray of stringopcional

IDs solicitados que NÃO transicionaram — não encontrados, não pertencentes à sua agência/cliente, ou não em um status de origem elegível. Sempre vazio no modo de filtro.

Erros

400Falta um parâmetro obrigatório na solicitação, ou ela é inválida de outra forma.

401Chave de API ausente, inválida, expirada ou revogada.

403A chave não tem a permissão exigida, ou não está autorizada para este cliente/local.

429Muitas solicitações. Tente novamente após o número de segundos indicado no cabeçalho Retry-After.

post/api/v1/listings/duplicates/resolve

Sua chave de API

Corpo da solicitação*

{
  "data": {
    "updated": 3,
    "skipped": []
  }
}