POST
/api/v4/locations/listings/mark-as-not-duplicate掲載情報を重複ではないとマークする
重複の可能性がある1件以上の掲載情報を誤検出として除外し、重複リストに表示されないようにします。
パラメーター
ボディ
| 名前 | 型 | 必須 | 説明 |
|---|---|---|---|
| input.listingItemIds | array | 必須 | Array of base64-encoded listing item IDs to dismiss as not 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 dismissed as not duplicates. On failure, `success` is `false` and `errors` describes why.
{ "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に設定してください。
ユースケース:キューから誤検出を除去する
検出では見逃しを避けるため、見た目が似ているだけの正当な掲載情報(2つ目の有効なプロフィール、同じフランチャイズの別の拠点、名称変更された拠点)にもフラグが付けられます。確認担当者がエントリを正しい掲載情報と確認したら、重複キューに不要な項目が残らないように除外してください。
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "listingItemIds": ["TGlzdGluZ0l0ZW06MjM1OTg0NTA="] }}listingItemIdsは必須で、複数のIDを受け付けます。1つの拠点の誤検出をすべて1回の呼び出しにまとめてください。success: trueを含む200で除外が確認できます。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=" ] } }'