/api/v4/locations/listings/mark-as-duplicateTandai profil bisnis sebagai duplikat
Menandai satu atau beberapa item profil bisnis yang terdeteksi sebagai duplikat yang telah dikonfirmasi agar Listings API dapat menyembunyikannya.
Parameter
Body
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| input.listingItemIds | array | wajib | Array of base64-encoded listing item IDs to mark as duplicates. Use the `listingItemId` values from the duplicate-listings endpoints. |
| input.locationId | string | opsional | Location that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location. |
Contoh permintaan
Body siap tempel. Ganti ID dan nilai placeholder dengan milik Anda.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}Respons
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.
Mengonfirmasi bahwa item profil bisnis tertentu merupakan duplikat, sehingga memberi sinyal kepada Listings API untuk menyembunyikan atau membersihkannya. Isi listingItemIds dengan nilai listingItemId yang dikembalikan oleh Dapatkan profil bisnis duplikat untuk suatu lokasi (atau nilai id dari rekap seluruh akun).
Kasus penggunaan: menindaklanjuti duplikat yang telah diperiksa
Setelah pemeriksa mengonfirmasi suatu grup duplikat, kirim ID item yang bermasalah dalam satu panggilan:
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}listingItemIds wajib diisi dan menerima beberapa ID, jadi gabungkan semua duplikat yang telah dikonfirmasi untuk suatu lokasi ke dalam satu permintaan alih-alih membuat satu panggilan per profil bisnis. 200 dengan success: true berarti item telah diterima untuk disembunyikan; 200 dengan success: false (atau 400) mengembalikan array errors yang berisi data; periksa code dan message pada setiap entri sebelum mencoba lagi.
Kasus penggunaan: membatalkan kesalahan
Jika suatu item keliru ditandai, batalkan penandaan tersebut dengan Tandai profil bisnis sebagai bukan duplikat, yang menerima struktur body yang sama. Ini merupakan operasi tulis dan diperhitungkan dalam batas laju permintaan akun, jadi utamakan penggabungan beberapa item dalam satu permintaan daripada mengirim permintaan per item.
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=" ] } }'