Bir hesaptaki tüm yinelenen işletme kayıtlarını alın

Parametreler

Sorgu

Ad	Tür	Zorunlu	Açıklama	Varsayılan
status	string	isteğe bağlı	Duplicate status to return: `POTENTIAL`, `PROCESSING`, `FIXED`, or `FAILED`. Case-insensitive.	POTENTIAL
siteId	integer	isteğe bağlı	Narrow to a single publisher by site ID. See the plan-sites endpoint for valid IDs.	—
tag	string	isteğe bağlı	Tag to scope the rollup to. Defaults to every location the key can see.	all
page	integer	isteğe bağlı	1-based page number.	1
perPage	integer	isteğe bağlı	Records per page.	—

Yanıtlar

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.

Her konumu tek tek sorgulamak yerine yinelenen işletme kayıtlarını toplu olarak inceleyip önceliklendirebilmeniz için tüm yayın platformu dizinlerindeki olası yinelenen işletme kayıtlarının hesap genelinde toplu görünümünü döndürür. Yukarıda gösterilen pageInfo/records yapısı, 12345 hesabı üzerinde canlı olarak doğrulanmıştır; bu hesapta şu anda açık yinelenen işletme kaydı bulunmadığından, gösterilen tek kayıt, yinelenen işletme kayıtları bulunan bir konumun döndürdüğü yapıyı temsil eder.

Kullanım senaryosu: her gece yinelenen işletme kayıtlarını engelleme taraması

Hesabın tamamındaki POTENTIAL yinelenen işletme kayıtlarını sayfa sayfa alın ve her id öğesini bir inceleme sorumlusuna iletin:

Code

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

Filtreler JSON değil, düz sorgu parametreleridir. status ve siteId parametrelerinin ikisi de isteğe bağlıdır. Hiçbiri sağlanmadığında status varsayılan olarak POTENTIAL, tag ise all değerini alır; dolayısıyla parametresiz bir GET /api/v4/locations/listings/duplicates, 400 yerine hesabın açık yinelenen işletme kayıtlarını döndürür. pageInfo.hasNextPage kullanarak ve page değerini false olana kadar artırarak sayfalar arasında ilerleyin; totalRecords ve totalPages ilerlemeyi göstermenizi sağlar.

Kullanım senaryosu: kapsamı kataloğunuzun bir bölümüyle sınırlama

Toplu görünüm her zaman anahtarın görebildiği tüm konumları kapsar. Bir alt kümeyi incelemek için sonuçları sayfa sayfa alın ve her kayıttaki locationId değerine göre gruplandırın veya ilgilendiğiniz konumlar için konum başına çalışan uç noktayı çağırın.

İşlem yapacağınız id öğelerini elde ettikten sonra bunları İşletme kaydını yinelenen olarak işaretleyin ile çözüme kavuşturun veya İşletme kaydını yinelenen değil olarak işaretleyin ile yanlış pozitifleri reddedin. Tek bir konumun siteye göre gruplandırılmış yinelenen işletme kayıtları için Bir konumun yinelenen işletme kayıtlarını alın uç noktasını kullanın. Bu, hesabın istek hızı sınırına tabi, sayfalandırılmış bir liste uç noktasıdır; 429 döndüğünde Retry-After başlığını kullanarak yeniden denemeden önce bekleyin.