/api/v4/connected-accounts/disconnect-googleBir Google hesabının bağlantısını kesin
Bağlı bir Google Business Profile hesabının tamamının Listings API hesabınızla olan bağlantısını keser.
Parametreler
Gövde
| Ad | Tür | Zorunlu | Açıklama |
|---|---|---|---|
| input | object | zorunlu | Wrapper object. The entire request body must be nested under `input`. |
| input.connectedAccountId | string | zorunlu | UUID of the connected Google account to disconnect. The whole account is disconnected. |
Örnek istek
Yapıştırmaya hazır gövde. Yer tutucu kimlikleri ve değerleri kendi değerlerinizle değiştirin.
{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" }}Yanıtlar
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.
Bağlı bir Google Business Profile hesabı ile Listings API hesabınız arasındaki bağlantıyı keser. Bağlantı kesildikten sonra, bu hesap üzerinden senkronize edilen işletme kayıtları Listings API'den güncelleme almayı durdurur.
İstek yapısı. Gövde, tek alanı connectedAccountId olan bir input nesnesiyle sarmalanmalıdır. Bu işlem ya tamamen uygulanır ya da hiç uygulanmaz; Google hesabının tamamının ve bu hesap üzerinden bağlanan tüm konumların bağlantısı kesilir. locationIds alanı yoktur; şema bu alanı reddeder. Hesabın bağlantısını koruyarak tek bir konumun işletme kaydının bağlantısını kesmek için disconnect-listing uç noktasını kullanın.
Kullanım senaryosu: bir müşteri ayrıldığında bağlantının tamamen sonlandırılması. Bağlantının tamamını tek bir çağrıda sonlandırmak için connectedAccountId gönderin. Bu, bir müşteri hizmeti kullanmayı bıraktıktan veya Google hesabının sahipliğini devrettikten sonra Listings API'nin erişimini iptal etmenin temiz yoludur.
Kullanım senaryosu: bozuk bir bağlantının sonlandırılması. Bir Google bağlantısında yeniden kimlik doğrulamayla giderilemeyen kimlik bilgisi hataları varsa, bağlantıyı buradan kesin ve connect-google uç noktasıyla yeni bir bağlantı oluşturun. Facebook hesapları için aynı istek yapısını kabul eden disconnect-facebook uç noktasını kullanın. Bilinmeyen bir connectedAccountId için bile success: true yanıtı döndürüldüğünü unutmayın; bu nedenle başarılı sonucu, etkin bir bağlantının kaldırıldığının kanıtı olarak değil, "istek işlendi" şeklinde değerlendirin ve emin olmanız gerekiyorsa hesabın durumunu GET /connected-accounts ile doğrulayın.
Bu uç nokta, etkin bir bağlantıyı değiştirir ve Listings API'nin Google'a erişimini iptal eder. Yukarıdaki istek yapısı ve örnek yanıt, API belirtimine dayanılarak belgelenmiştir; çağrı, üretim verileri üzerinde yürütülmez.
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" } }'