获取已连接账户的详细信息

名称	类型	必填	描述
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 地点数量。

获取已连接账户的详细信息

参数

路径

响应