/api/v4/locations/listings/mark-as-duplicateEintrag als Duplikat markieren
Markiert einen oder mehrere erkannte Einträge als bestätigte Duplikate, damit Listings API sie unterdrücken kann.
Parameter
Body
| Name | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
| input.listingItemIds | array | erforderlich | Array of base64-encoded listing item IDs to mark as duplicates. Use the `listingItemId` values from the duplicate-listings endpoints. |
| input.locationId | string | optional | Location that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location. |
Beispielanfrage
Body zum direkten Einfügen. Ersetzen Sie Platzhalter-IDs und -Werte durch Ihre eigenen.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}Antworten
200Listing items marked as duplicates. On failure, `success` is `false` and `errors` describes why.
{ "data": { "markAsDuplicate": { "success": true, "errors": null } }}400Validation error, e.g. an unknown or malformed listing item ID. See the `errors` array (`code`, `message`, `path`).
401Unauthenticated, missing or invalid API key.
Bestätigt, dass bestimmte Einträge Duplikate sind, und signalisiert Listings API, sie zu unterdrücken oder zu bereinigen. Befüllen Sie listingItemIds mit den listingItemId-Werten, die von Doppelte Einträge für einen Standort abrufen zurückgegeben werden (oder mit den id-Werten aus der kontoweiten Zusammenfassung).
Anwendungsfall: Maßnahmen für ein geprüftes Duplikat ergreifen
Nachdem eine prüfende Person eine Duplikatgruppe bestätigt hat, übermitteln Sie die IDs der betreffenden Einträge in einem einzigen Aufruf:
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}listingItemIds ist erforderlich und akzeptiert mehrere IDs. Fassen Sie daher alle bestätigten Duplikate für einen Standort in einer Anfrage zusammen, anstatt einen Aufruf pro Eintrag auszuführen. Ein 200 mit success: true bedeutet, dass die Einträge zur Unterdrückung angenommen wurden; ein 200 mit success: false (oder ein 400) gibt ein befülltes errors-Array zurück; prüfen Sie bei jedem Eintrag code und message, bevor Sie es erneut versuchen.
Anwendungsfall: einen Fehler rückgängig machen
Wenn ein Eintrag irrtümlich markiert wurde, machen Sie dies mit Eintrag als Nicht-Duplikat markieren rückgängig; dabei wird dieselbe Struktur des Anfragekörpers verwendet. Dies ist ein Schreibvorgang und wird auf das Anfragelimit des Kontos angerechnet. Bevorzugen Sie daher gebündelte Anfragen gegenüber einzelnen Anfragen pro Eintrag.
curl -X POST 'https://listingsapi.com/api/v4/locations/listings/mark-as-duplicate' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": [ "TGlzdGluZ0l0ZW06MjM1OTg0NTA=" ] } }'