Listings APIListings API
登入
POST/api/v4/locations/listings/mark-as-duplicate

將商家資訊標記為重複

將偵測到的一個或多個商家資訊項目標記為已確認的重複項目，讓 Listings API 能夠移除這些項目。

需要 API 金鑰。標頭格式與金鑰輪替請參閱驗證。

參數

請求主體

名稱類型必填說明
input.listingItemIdsarray必填Array of base64-encoded listing item IDs to mark as duplicates. Use the `listingItemId` values from the duplicate-listings endpoints.
input.locationIdstring選填Location that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location.

請求範例

可直接貼上的請求主體。請將預留位置 ID 與值換成您自己的。

Request body
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]  }}

回應

200Listing items marked as duplicates. On failure, `success` is `false` and `errors` describes why.
Response
{  "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.

確認特定商家資訊項目為重複項目，指示 Listings API 移除或清理這些項目。請將 取得地點的重複商家資訊 傳回的 listingItemId 值（或帳戶範圍彙總中的 id 值）填入 listingItemIds。

使用案例：處理已審查的重複項目

審查人員確認重複群組後，請透過單次呼叫提交其中重複項目的 ID：

JSON
{  "input": {    "locationId": "TG9jYXRpb246MTgwMDI4OQ==",    "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="]  }}

listingItemIds 為必填欄位，且接受多個 ID，因此請將某個地點所有已確認的重複項目整批放入同一個請求，而非針對每筆商家資訊分別呼叫。200 且 success: true 表示已接受這些項目的移除處理；200 且 success: false（或 400）會傳回含有資料的 errors 陣列，請在重試前檢查每個項目的 code 和 message。

使用案例：復原誤操作

如果某個項目被誤標記，請使用 將商家資訊標記為非重複 撤銷標記，此操作接受相同的請求主體結構。這是寫入操作，會計入帳戶的速率限制，因此請優先使用批次處理，而非逐項傳送請求。

Request
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="      ]    }  }'
Run in playground