/api/v4/locations/listings/mark-as-duplicateİşletme kaydını mükerrer olarak işaretleme
Listings API'nin bunları gizleyebilmesi için tespit edilen bir veya daha fazla işletme kaydı öğesini doğrulanmış mükerrer öğeler olarak işaretler.
Parametreler
Gövde
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| input.listingItemIds | array | zorunlu | Array of base64-encoded listing item IDs to mark as duplicates. Use the `listingItemId` values from the duplicate-listings endpoints. |
| input.locationId | string | isteğe bağlı | Location that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location. |
Örnek istek
Yapıştırmaya hazır gövde. Yer tutucu kimlikleri ve değerleri kendi değerlerinizle değiştirin.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}Yanıtlar
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.
Belirli işletme kaydı öğelerinin mükerrer olduğunu doğrulayarak Listings API'ye bunları gizlemesi veya temizlemesi için sinyal gönderir. listingItemIds alanını Bir konumun mükerrer işletme kayıtlarını alma işleminin döndürdüğü listingItemId değerleriyle (veya hesap genelindeki toplu sonuçlardan alınan id değerleriyle) doldurun.
Kullanım senaryosu: incelenmiş bir mükerrer kayıt için işlem yapma
İncelemeyi yapan kişi mükerrer kayıt grubunu doğruladıktan sonra, ilgili öğelerin ID'lerini tek bir çağrıda gönderin:
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}listingItemIds zorunludur ve birden fazla ID kabul eder; bu nedenle işletme kaydı başına bir çağrı yapmak yerine bir konum için doğrulanmış tüm mükerrer kayıtları tek bir istekte toplu olarak gönderin. success: true içeren bir 200, öğelerin gizlenmek üzere kabul edildiği anlamına gelir; success: false içeren bir 200 (veya bir 400), doldurulmuş bir errors dizisi döndürür; yeniden denemeden önce her girdinin code ve message değerlerini inceleyin.
Kullanım senaryosu: bir hatayı geri alma
Bir öğe yanlışlıkla işaretlendiyse aynı gövde yapısını kabul eden İşletme kaydını mükerrer değil olarak işaretleme işlemiyle bu işaretlemeyi geri alın. Bu bir yazma işlemidir ve hesabın istek hızı limitine dahil edilir; bu nedenle öğe başına istek göndermek yerine toplu istekleri tercih edin.
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=" ] } }'