Synup
Criar chave
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": []
  }
}

Guias que usam este endpoint