/api/v4/connected-accounts/disconnect-google断开 Google 账号连接
将整个已连接的 Google Business Profile 账号与您的 Listings API 账户断开连接。
参数
请求体
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| input | object | 必填 | Wrapper object. The entire request body must be nested under `input`. |
| input.connectedAccountId | string | 必填 | UUID of the connected Google account to disconnect. The whole account is disconnected. |
请求示例
可直接粘贴的请求体。请将占位 ID 和值替换为您自己的。
{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" }}响应
200Request accepted. `success: true` confirms the disconnect was processed.
{ "data": { "gmbBulkDisconnect": { "success": true } }}400Bad request, the body was not wrapped in `input`, or `connectedAccountId` was omitted (error message: `Field value.connectedAccountId of required type String! was not provided`).
401Unauthenticated, missing or invalid API key.
切断已连接的 Google Business Profile 账号与您的 Listings API 账户之间的连接。断开连接后，此前通过该账号同步的商家信息将不再接收来自 Listings API 的更新。
请求结构。 请求体必须封装在一个 input 对象中，该对象只能包含 connectedAccountId 字段。此操作会整体生效：整个 Google 账号及通过该账号关联的所有地点都会断开连接。请求中没有 locationIds 字段；schema 会拒绝它。要在保持账号连接的同时取消关联单个地点的商家信息，请使用 disconnect-listing 端点。
使用场景：客户离开时彻底断开连接。 发送 connectedAccountId，即可通过一次调用彻底断开整个连接。在客户流失或转移其 Google 账号所有权后，这是撤销 Listings API 访问权限最彻底的方式。
使用场景：断开异常连接。 如果 Google 连接存在重新认证也无法解决的凭据错误，请在此处断开连接，然后通过 connect-google 端点生成一个新的链接。对于 Facebook 账号，请使用 disconnect-facebook 端点，其请求结构相同。请注意，即使 connectedAccountId 未知，也会返回 success: true 响应，因此应将成功视为“请求已处理”，而非已移除有效连接的证明；如果您需要确认，请使用 GET /connected-accounts 核实账号状态。
此端点会修改正在使用的连接，并撤销 Listings API 对 Google 的访问权限。上述请求结构和示例响应依据 API 规范编写；该调用未针对生产数据执行。
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-google' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" } }'