جلب جميع إدراجات الأنشطة التجارية المكررة لحساب

المعلمات

الاستعلام

الاسم	النوع	مطلوب	الوصف	الافتراضي
status	string	اختياري	Duplicate status to return: `POTENTIAL`, `PROCESSING`, `FIXED`, or `FAILED`. Case-insensitive.	POTENTIAL
siteId	integer	اختياري	Narrow to a single publisher by site ID. See the plan-sites endpoint for valid IDs.	—
tag	string	اختياري	Tag to scope the rollup to. Defaults to every location the key can see.	all
page	integer	اختياري	1-based page number.	1
perPage	integer	اختياري	Records per page.	—

الاستجابات

200Paginated rollup of duplicate listing records across the account.

Response

{  "data": {    "duplicateListingsRollup": {      "pageInfo": {        "hasNextPage": true,        "hasPreviousPage": false,        "totalPages": 34,        "totalRecords": 1673      },      "records": [        {          "id": "3329229",          "name": "Woodbury Train Station",          "nameValid": false,          "duplicateProcessingState": "POTENTIAL",          "liveLink": "http://citysquares.com/b/woodbury-train-station-23598450",          "locationId": "73451",          "siteName": "City Squares",          "siteUrl": "citysquares.com"        }      ]    }  }}

400An invalid `status` value, e.g. one outside `POTENTIAL` / `PROCESSING` / `FIXED` / `FAILED`.

401Unauthenticated, missing or invalid API key.

429Rate limit exceeded. Retry after the `Retry-After` header value.

يُرجع عرضًا على مستوى الحساب لإدراجات الأنشطة التجارية المحتمل تكرارها عبر جميع أدلة منصات النشر، مجمّعًا بحيث يمكنك فرز الإدراجات المكررة دفعة واحدة بدلًا من الاستعلام عن كل موقع على حدة. تحققنا فعليًا من بنية pageInfo/records الموضّحة أعلاه على الحساب 12345؛ ولا توجد حاليًا في ذلك الحساب إدراجات مكررة مفتوحة، لذا فإن السجل الوحيد يمثّل البنية التي يُرجعها موقع لديه إدراجات مكررة.

حالة استخدام: فحص ليلي لإخفاء الإدراجات المكررة

تصفّح صفحات الإدراجات المكررة ذات الحالة POTENTIAL للحساب بأكمله، وسلّم كل id إلى مسؤول مراجعة:

Code

GET /api/v4/locations/listings/duplicates?status=POTENTIAL&page=1

عوامل التصفية هي معاملات استعلام مسطّحة، وليست JSON. كلٌّ من status وsiteId اختياري. عند عدم توفير أيٍّ منهما، تكون القيمة الافتراضية لـ status هي POTENTIAL، ولـ tag هي all، لذا يُرجع طلب GET /api/v4/locations/listings/duplicates دون معاملات الإدراجات المكررة المفتوحة للحساب بدلًا من 400. تصفّح الصفحات باستخدام pageInfo.hasNextPage وزيادة page حتى تصبح قيمته false؛ ويتيح لك totalRecords وtotalPages عرض التقدّم.

حالة استخدام: حصر النطاق في جزء واحد من كتالوجك

يشمل التجميع دائمًا جميع المواقع التي يمكن للمفتاح الاطّلاع عليها. لمراجعة مجموعة فرعية، تصفّح صفحات النتيجة وجمّع السجلات حسب locationId الموجود في كل سجل، أو استدعِ نقطة النهاية الخاصة بكل موقع للمواقع التي تهمّك.

بمجرد أن تصبح لديك عناصر id لاتخاذ إجراء بشأنها، عالجها باستخدام وضع علامة على إدراج نشاط تجاري بأنه مكرر أو استبعد الحالات التي صُنّفت خطأً على أنها مكررة باستخدام وضع علامة على إدراج نشاط تجاري بأنه غير مكرر. للحصول على الإدراجات المكررة لموقع واحد مجمّعة حسب الموقع الإلكتروني، استخدم جلب إدراجات الأنشطة التجارية المكررة لموقع. هذه نقطة نهاية لقائمة مقسّمة إلى صفحات تخضع لحد معدل الطلبات الخاص بالحساب؛ وعند تلقّي 429، انتظر قبل إعادة المحاولة باستخدام ترويسة Retry-After.