取得已連結帳戶的詳細資料

名稱	類型	必填	說明
connectedAccountId	string	必填	UUID of the connected account (from the list connected accounts endpoint).

名稱

類型

必填

說明

connectedAccountId

string

必填

UUID of the connected account (from the list connected accounts endpoint).

回應

200Connected account details.

Response

{  "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.

透過 connectedAccountId 取得單一已連結帳戶的完整詳細資料記錄。傳回的欄位與清單端點中的單筆記錄相同，但範圍僅限於一個帳戶，因此在您已持有 ID 時，這比逐頁取得整份清單的成本更低。

使用案例：輪詢剛連結的帳戶。 客戶完成 Google 連結流程後，您會持有 connectedAccountId，但配對擷取作業會以非同步方式執行。請輪詢此端點並觀察 requestMatchesStatus：建議準備就緒後，其值會從 MATCH_IN_PROGRESS 變為 MATCH_COMPLETED，此時您即可從 connection-suggestions 端點讀取這些建議。

使用案例：顯示重新驗證提示。 透過帳戶推送更新前，請先讀取 status 和 connectivityIssue。狀態不是 CONNECTED，或 connectivityIssue 有值，都表示 OAuth 授權已過期；請在您的應用程式中提示客戶重新連結，而不要嘗試執行必定失敗的發布作業。connectedLocationsCount 會告訴您目前有多少個 Listings API 地點連結至該帳戶。

取得已連結帳戶的詳細資料

參數

路徑

回應