/api/v4/connected-accounts/{connectedAccountId}/detailsOttieni i dettagli di un account collegato
Restituisce i dettagli di un singolo account Google o Facebook collegato tramite il suo ID.
Parametri
Percorso
| Nome | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| connectedAccountId | string | obbligatorio | UUID of the connected account (from the list connected accounts endpoint). |
Risposte
200Connected account details.
{ "data": { "connectedAccountDetails": { "details": { "accountId": "12345", "clientName": "owner@brightsmile-dental.com", "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5", "connectedAccountType": "GoogleAccount", "connectedLocationsCount": 0, "connectivityIssue": null, "email": "owner@brightsmile-dental.com", "lastFetchMatchesRequestedAt": "2026-07-06 21:43:07 UTC", "remarks": null, "requestMatches": false, "requestMatchesStatus": "MATCH_COMPLETED", "status": "CONNECTED" } } }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Recupera il record completo dei dettagli di un singolo account collegato, identificato dal suo connectedAccountId. Restituisce gli stessi campi di un record dell'endpoint di elenco, ma limitatamente a un solo account, con un costo inferiore rispetto alla consultazione di tutte le pagine dell'elenco quando disponi già dell'ID.
Caso d'uso: interroga periodicamente un account appena collegato. Dopo che un cliente completa la procedura di collegamento a Google, disponi di un connectedAccountId, ma il recupero delle corrispondenze viene eseguito in modo asincrono. Interroga periodicamente questo endpoint e monitora requestMatchesStatus: passa da MATCH_IN_PROGRESS a MATCH_COMPLETED quando i suggerimenti sono pronti, e a quel punto puoi leggerli dall'endpoint connection-suggestions.
Caso d'uso: mostra un messaggio per ripetere l'autenticazione. Prima di inviare aggiornamenti tramite un account, leggi status e connectivityIssue. Uno stato diverso da CONNECTED o un campo connectivityIssue valorizzato indica che l'autorizzazione OAuth è scaduta; invita il cliente a ricollegare l'account nella tua app invece di tentare una pubblicazione destinata a fallire. connectedLocationsCount indica quante sedi di Listings API sono attualmente collegate all'account.
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/details' \ -H "Authorization: API $LISTINGSAPI_KEY"