وضع علامة على إدراج نشاط تجاري بأنه غير مكرر

المعلمات

النص الأساسي

الاسم	النوع	مطلوب	الوصف
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.

الاستجابات

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.

يستبعد حالات التكرار المحتملة باعتبارها نتائج إيجابية كاذبة. بعد استبعادها، تُعلَّم العناصر على أنها مؤكَّدة غير مكررة، ولا تعود تظهر في جلب إدراجات الأنشطة التجارية المكررة لموقع أو في الملخص المجمّع على مستوى الحساب. املأ listingItemIds بقيم listingItemId من نقاط النهاية تلك.

حالة استخدام: إزالة النتائج الإيجابية الكاذبة من قائمة الانتظار

يتوخى الاكتشاف الحذر، لذا سيضع علامة على إدراجات أنشطة تجارية صحيحة لمجرد أنها تبدو متشابهة (ملف تعريفي ثانٍ صالح، أو فرع آخر تابع للامتياز التجاري نفسه، أو موقع تغيّر اسمه). عندما يؤكد أحد المراجعين أن أحد العناصر هو إدراج النشاط التجاري الصحيح، استبعده كي يتوقف عن إرباك قائمة انتظار التكرارات:

JSON

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

الحقل listingItemIds مطلوب ويقبل معرّفات متعددة: اجمع كل النتائج الإيجابية الكاذبة لموقع في استدعاء واحد. تؤكد 200 مع success: true الاستبعاد؛ وتُعيد success: false أو 400 مصفوفة errors تحتوي على عناصر لفحصها.

حالة استخدام: عكس الحجب

نقطة النهاية هذه هي النظير المقابل لـوضع علامة على إدراج نشاط تجاري بأنه مكرر وتقبل بنية جسم الطلب نفسها؛ استخدمها لعكس الإجراء على عنصر وُضعت عليه علامة بالخطأ. كلتاهما عمليتا كتابة تُحتسبان ضمن حد معدل الطلبات للحساب، لذا يُفضّل تجميع العناصر في دفعات على إرسال طلب لكل عنصر.

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=" ] } }'