v1Ressourcen/Duplicate Listings/postDoppelte Listings beheben

Doppelte Listings beheben

Markiert doppelte Listings zur Entfernung oder verwirft sie, entweder über eine explizite Liste von duplicateListingIds oder über einen Filter mit derselben Form wie die Rollup-Warteschlange. Der Filtermodus läuft als eine einzige Massenaktualisierung, beschränkt auf die Schnittmenge der eigenen Status des Filters und der zulässigen Ausgangsstatus der Aktion — er kann nie Zeilen außerhalb dessen erreichen, was dieser Filter anzeigen würde. Das Markieren entfernt das Listing selbst nicht; es reiht die Entfernungsanfrage ein, die ein Hintergrundjob beim Publisher ausführt.

post/api/v1/listings/duplicates/resolve

listings:write

Anfragetext

actionstring (flag | dismiss)erforderlich

flag (Entfernung beim Publisher beantragen) oder dismiss (als kein Duplikat markieren).

duplicateListingIdsarray of stringoptional

Explizite IDs zum Beheben, bis zu 1000. Schließt sich mit filter gegenseitig aus.

filterobjectoptional

Jede zutreffende Zeile, die diesem Filter entspricht, beheben, statt IDs explizit zu benennen. Ein auf bestimmte Kunden beschränkter Schlüssel muss im Filtermodus ebenfalls clientId übergeben.

filterstring (potential | flagged | deleted | failed)optional

Auf einen Status beschränken: potential, flagged, deleted oder failed.

bandstring (high | med | low)optional

Auf eine Konfidenzstufe beschränken: high, med oder low.

publisherSiteIdintegeroptional

Auf einen Publisher beschränken, über dessen numerische Site-ID.

locationIdstringoptional

Auf einen Standort beschränken.

searchstringoptional

Freitextsuche über Firmenname, Adresse und Telefonnummer.

clientIdstringoptional

Erforderlich, wenn Ihr Schlüssel auf bestimmte Kunden beschränkt ist und Sie den Filtermodus verwenden (der ID-Modus ist pro ID selbstbegrenzend und benötigt dies nicht).

Antwort

dataobjectoptional

updatednumberoptional

Anzahl der doppelten Listings, die in den neuen Status übergegangen sind.

skippedarray of stringoptional

Angeforderte IDs, die NICHT übergegangen sind — nicht gefunden, nicht im Besitz Ihrer Agentur/Ihres Kunden, oder nicht in einem zulässigen Ausgangsstatus. Im Filtermodus immer leer.

Fehler

400Der Anfrage fehlt ein erforderlicher Parameter, oder sie ist anderweitig fehlerhaft.

401API-Schlüssel fehlt, ist ungültig, abgelaufen oder widerrufen.

403Dem Schlüssel fehlt die erforderliche Berechtigung, oder er ist für diesen Kunden/Standort nicht autorisiert.

429Zu viele Anfragen. Versuchen Sie es nach der im Retry-After-Header angegebenen Anzahl Sekunden erneut.

post/api/v1/listings/duplicates/resolve

Ihr API-Schlüssel

Anfragetext*

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