POST/api/v4/locations/listings/mark-as-not-duplicate

將商家資訊標記為非重複

將一或多筆疑似重複的商家資訊判定為誤判並排除,使其不再出現在重複商家資訊清單中。

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

參數

請求主體

名稱類型必填說明
input.listingItemIdsarray必填Array of base64-encoded listing item IDs to dismiss as not 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 dismissed as not duplicates. On failure, `success` is `false` and `errors` describes why.
Response
{  "data": {    "markAsNotDuplicate": {      "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.

將疑似重複的商家資訊判定為誤判並排除。排除後,這些項目會標記為已確認非重複,且不再出現在取得地點的重複商家資訊或整個帳戶的彙總結果中。請使用這些端點傳回的 listingItemId 值填入 listingItemIds。

使用案例:從佇列中清除誤判項目

偵測機制採取保守策略,會將僅外觀相似的有效商家資訊標記為疑似重複(例如另一個有效的商家檔案、同一加盟體系的其他分店,或已更名的地點)。當審查人員確認某個項目是正確的商家資訊時,請將其排除,使其不再佔據重複商家資訊佇列:

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

listingItemIds 為必填,且可接受多個 ID:請將同一地點的所有誤判項目合併至一次呼叫中。200 且 success: true 表示已確認排除;success: false 或 400 會傳回含有資料的 errors 陣列供您檢查。

使用案例:移除的反向操作

此端點與將商家資訊標記為重複相互對應,且接受完全相同的主體結構,您可使用此端點還原被誤標記的項目。兩者都是寫入操作,皆會計入帳戶的速率限制,因此請優先使用批次處理,而非逐一傳送請求。

Request
curl -X POST 'https://listingsapi.com/api/v4/locations/listings/mark-as-not-duplicate' \  -H "Authorization: API $LISTINGSAPI_KEY" \  -H 'Content-Type: application/json' \  -d '{    "input": {      "locationId": "TG9jYXRpb246MTgwMDI4OQ==",      "listingItemIds": [        "TGlzdGluZ0l0ZW06MjM1OTg0NTA="      ]    }  }'