v1Recursos/Duplicate Listings/postResolver listados duplicados

Resolver listados duplicados

Marca listados duplicados para su eliminación (flag), o los descarta (dismiss), ya sea mediante una lista explícita de duplicateListingIds o mediante un filtro con la misma forma que la cola del resumen. El modo de filtro se ejecuta como una única actualización masiva limitada a la intersección entre los propios estados del filtro y los estados de origen admitidos por la acción — nunca puede alcanzar filas fuera de lo que ese filtro mostraría. Marcar no elimina el listado en sí; encola la solicitud de eliminación, que un trabajo en segundo plano ejecuta frente al publisher.

post/api/v1/listings/duplicates/resolve

listings:write

Cuerpo de la solicitud

actionstring (flag | dismiss)obligatorio

flag (solicitar la eliminación al publisher) o dismiss (marcar como que no es un duplicado).

duplicateListingIdsarray of stringopcional

IDs explícitos a resolver, hasta 1000. Mutuamente excluyente con filter.

filterobjectopcional

Resuelve toda fila admisible que coincida con este filtro, en lugar de indicar ids explícitamente. Una clave limitada a clientes específicos también debe indicar clientId al usar el modo de filtro.

filterstring (potential | flagged | deleted | failed)opcional

Restringe a un estado: potential, flagged, deleted o failed.

bandstring (high | med | low)opcional

Restringe a un nivel de confianza: high, med o low.

publisherSiteIdintegeropcional

Restringe a un publisher, por su id numérico de sitio.

locationIdstringopcional

Restringe a una ubicación.

searchstringopcional

Búsqueda de texto libre en el nombre de negocio, la dirección y el teléfono.

clientIdstringopcional

Obligatorio cuando su clave está limitada a clientes específicos y usa el modo de filtro (el modo por id ya se autolimita por cada id y no lo necesita).

Respuesta

dataobjectopcional

updatednumberopcional

Número de listados duplicados que pasaron al nuevo estado.

skippedarray of stringopcional

IDs solicitados que NO cambiaron de estado — no encontrados, no pertenecientes a su agencia/cliente, o no en un estado de origen admisible. Siempre vacío en el modo de filtro.

Errores

400A la solicitud le falta un parámetro obligatorio o es inválida de otra forma.

401La clave de API falta, es inválida, expiró o fue revocada.

403A la clave le falta el permiso requerido, o no está autorizada para este cliente/ubicación.

429Demasiadas solicitudes. Reintente tras el número de segundos indicado en el encabezado Retry-After.

post/api/v1/listings/duplicates/resolve

Su clave de API

Cuerpo de la solicitud*

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