Synup
Crear clave
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": []
  }
}

Guías que usan este endpoint