Ottieni tutte le schede duplicate di un account

Parametri

Query

Nome	Tipo	Obbligatorio	Descrizione	Predefinito
status	string	facoltativo	Duplicate status to return: `POTENTIAL`, `PROCESSING`, `FIXED`, or `FAILED`. Case-insensitive.	POTENTIAL
siteId	integer	facoltativo	Narrow to a single publisher by site ID. See the plan-sites endpoint for valid IDs.	—
tag	string	facoltativo	Tag to scope the rollup to. Defaults to every location the key can see.	all
page	integer	facoltativo	1-based page number.	1
perPage	integer	facoltativo	Records per page.	—

Risposte

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.

Restituisce una vista a livello di account delle potenziali schede duplicate in tutte le directory delle piattaforme di pubblicazione, aggregate in modo da consentirti di esaminare i duplicati in blocco anziché interrogare una sede alla volta. La struttura pageInfo/records mostrata sopra è stata verificata dal vivo sull'account 12345; al momento quell'account non ha duplicati aperti, quindi il singolo record è rappresentativo della struttura restituita per una sede con duplicati.

Caso d'uso: controllo notturno per la soppressione dei duplicati

Scorri le pagine dei duplicati POTENTIAL dell'intero account e passa ogni id a un revisore:

Code

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

I filtri sono parametri di query non annidati, non JSON. status e siteId sono entrambi facoltativi. Se non viene fornito nessuno dei due, status assume il valore predefinito POTENTIAL e tag il valore predefinito all, quindi una semplice chiamata GET /api/v4/locations/listings/duplicates restituisce i duplicati aperti dell'account anziché un 400. Scorri le pagine usando pageInfo.hasNextPage e incrementando page finché non è false; totalRecords e totalPages ti consentono di mostrare l'avanzamento.

Caso d'uso: limita l'ambito a un segmento del tuo catalogo

Il riepilogo include sempre tutte le sedi a cui la chiave ha accesso. Per esaminare un sottoinsieme, scorri le pagine del risultato e raggruppa i record in base al valore locationId presente in ciascuno di essi, oppure chiama l'endpoint per singola sede per le sedi che ti interessano.

Una volta ottenuti gli elementi id su cui intervenire, risolvili con Contrassegna una scheda come duplicata oppure scarta i falsi positivi con Contrassegna una scheda come non duplicata. Per ottenere i duplicati di una singola sede raggruppati per sito, usa Ottieni le schede duplicate di una sede. Questo endpoint restituisce un elenco paginato ed è soggetto al limite di frequenza dell'account; in caso di 429, attendi prima di riprovare usando l'header Retry-After.