POST
/api/v4/locations/listings/mark-as-duplicate将商家信息标记为重复
将一个或多个检测到的商家信息条目标记为已确认的重复项，以便 Listings API 屏蔽这些条目。
参数
请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| input.listingItemIds | array | 必填 | Array of base64-encoded listing item IDs to mark as duplicates. Use the `listingItemId` values from the duplicate-listings endpoints. |
| input.locationId | string | 可选 | Location that owns the listing items (base64-encoded Relay ID or raw numeric ID). Scopes the operation to a single location. |
请求示例
可直接粘贴的请求体。请将占位 ID 和值替换为您自己的。
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}响应
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.
确认特定商家信息条目为重复项，指示 Listings API 屏蔽或清理这些条目。将 获取地点的重复商家信息 返回的 listingItemId 值（或账户范围汇总中的 id 值）填入 listingItemIds。
使用场景：处理已审核的重复项
审核人员确认一组重复项后，在一次调用中提交其中需要处理的条目 ID：
{ "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=" ] } }'