/api/v4/connected-accounts/disconnect-facebookBir Facebook hesabının bağlantısını kesme
Daha önce bağlanmış bir Facebook Pages hesabının Listings API hesabınızla 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 Facebook 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": { "fbBulkDisconnect": { "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 Facebook Pages 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 ve Facebook etkileşimleri kontrol panelinde artık görünmez.
İstek yapısı. Gövde, tek alanı connectedAccountId olan bir input nesnesi içinde yer almalıdır. Bu işlem ya tamamen uygulanır ya da hiç uygulanmaz; bağlı hesabın tamamını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 bunun yerine disconnect-listing uç noktasını kullanın.
Kullanım senaryosu: ayrılan bir müşterinin hizmetini sonlandırma. Bir müşteri hizmeti iptal ettiğinde, Listings API'nin müşterinin sayfalarını yönetmeyi durdurması ve müşteri adına başka gönderi veya yanıt gönderilmemesi için müşterinin Facebook hesabının bağlantısını kesin. Hesabın bağlantısını tamamen kesmek için müşterinin connectedAccountId değerini (GET /connected-accounts üzerinden alınır) sağlayın.
Kullanım senaryosu: bozuk bir bağlantıyı yeniden yetkilendirme. Bir Facebook bağlantısında yeniden kimlik doğrulamayla giderilemeyen kimlik bilgisi hataları varsa, bağlantıyı burada kesin ve connect-facebook uç noktasıyla yeni bir bağlantı oluşturun. success: true, bağlantının kesildiğini doğrular. Google için disconnect-google uç noktasını kullanın. Bilinmeyen bir connectedAccountId için bile success: true yanıtının 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.
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-facebook' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" } }'