Listings APIListings API
登入
POST/api/v4/connected-accounts/disconnect-google

中斷 Google 帳戶連結

將整個已連結的 Google Business Profile 帳戶與您的 Listings API 帳戶中斷連結。

需要 API 金鑰。標頭格式與金鑰輪替請參閱驗證。

參數

請求主體

名稱類型必填說明
inputobject必填Wrapper object. The entire request body must be nested under `input`.
input.connectedAccountIdstring必填UUID of the connected Google account to disconnect. The whole account is disconnected.

請求範例

可直接貼上的請求主體。請將預留位置 ID 與值換成您自己的。

Request body
{  "input": {    "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d"  }}

回應

200Request accepted. `success: true` confirms the disconnect was processed.
Response
{  "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 欄位；結構描述會拒絕此欄位。若要解除單一地點的商家資訊連結，同時保持帳戶連結，請使用 disconnect-listing 端點。

使用案例：客戶離開時完整終止服務。 傳送 connectedAccountId，即可透過一次呼叫移除整個連結。這是在客戶流失或移轉其 Google 帳戶擁有權後，撤銷 Listings API 存取權最直接的做法。

使用案例：移除故障的連結。 如果 Google 連結發生重新驗證也無法排除的憑證錯誤，請在此中斷連結，再透過 connect-google 端點產生新的連結。若是 Facebook 帳戶，請使用 disconnect-facebook 端點，其接受的請求格式相同。請注意，即使 connectedAccountId 未知，仍會傳回 success: true 回應，因此請將成功視為「請求已處理」，而非已移除有效連結的證明；若您需要確認，請使用 GET /connected-accounts 確認帳戶狀態。

此端點會變更有效連結，並撤銷 Listings API 對 Google 的存取權。上述請求格式與範例回應是根據 API 規格記錄的；此呼叫並未針對正式環境資料執行。

Request
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"    }  }'
Run in playground