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

المعلمات

النص الأساسي

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

الاستجابات

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 إخفاؤها أو إزالتها. املأ listingItemIds بقيم listingItemId التي تُرجعها جلب إدراجات الأنشطة التجارية المكررة لموقع (أو بقيم id من التجميع على مستوى الحساب بأكمله).

حالة استخدام: اتخاذ إجراء بشأن إدراج مكرر بعد مراجعته

بعد أن يؤكد أحد المراجعين أن مجموعة من إدراجات الأنشطة التجارية مكررة، أرسل معرّفات العناصر المعنية في استدعاء واحد:

JSON

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

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

حالة استخدام: التراجع عن خطأ

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

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