Bir bağlantıyı kesin

Bağlı bir sosyal hesabı markasından kaldırır. Marka doğrudan belirtilmez: bağlantı kimliği her ikisini de tanımlar. Bu, iptal süresi ve geri alma olanağı olmayan tek yönlü bir işlemdir. Kanalı yeniden bağlamak için yeni bir bağlantı kurma bağlantısı oluşturun ve kullanıcının yeniden yetki vermesini sağlayın.

Kullanım örneği: bir müşteri bir kanala erişimi iptal eder. Bir müşteri bir Sayfayı kontrolünüzden çıkardığında, zamanlanmış gönderilerin o kanalda yayımlanmaya çalışmasını durdurmak için kanalın bağlantısını kesin. Markanın bağlantılarından id değerini okuyun, bağlantıyı kesin ve ardından doğrulamak için listeyi yeniden okuyun.

Notlar.

• İstek gövdesi bir input nesnesi içinde yer almalıdır. Alan socialProfileConnectedChannelId şeklindedir; bu, bağlantının kendi UUID değeridir, platformun connectedAccountId değeri veya marka kimliği değildir.
• HTTP durumunu değil, success değerini kontrol edin. Farklı bir markaya ait olan veya artık mevcut olmayan bir bağlantı için success: false ile birlikte HTTP 200 döndürülür. Yanıt gövdesi herhangi bir kimlik içermez, bu nedenle hangi bağlantının kaldırılmasını istediğinizi kendi kayıtlarınızda tutun.
• Benzer adlara dikkat edin. Bu gövde alanı socialProfileConnectedChannelId şeklindedir ve ortasında Profile bulunur. Yanındaki insights uç noktası, aynı kimliği bir kelime daha kısa olan socialConnectedChannelId alanıyla alır. Aralarında bir kelime fark vardır ve hiçbiri diğerinin adını kabul etmez.
• Zamanlanmış gönderiler iptal edilmez. Bu kanalda yayımlanmak üzere zamanlanmış bir gönderi, işlemden çıkarılmak yerine yayımlanma zamanı geldiğinde SY95045 hatasıyla başarısız olur. Bu hatanın oluşmasını istemiyorsanız önce POST /social/posts/cancel ile gönderiyi iptal edin.
• Daha önce yayımlanmış gönderiler yayında kalır. Bağlantının kesilmesi, listingsAPI'nin gönderi yayımlama ve istatistikleri okuma yetkisini kaldırır; platformdan hiçbir şey silmez.
• Yuva, işlem başarılı olduğunda değil, yenileme sırasında havuza döner. GET /social/limits bunu hemen daha düşük bir usage.connectionsActive ve daha yüksek bir usage.connectionsReleased değeriyle gösterir; üst sınırın uygulandığı faturalandırılabilir sayı olan usage.connections ise yeni faturalandırma dönemi başlayana kadar değişmez. usage.connectionsReleased, yenileme sırasında geri kazanılan kapasite miktarıdır. Planlar ve eklentiler bölümüne bakın.
• Aynı hesabı aynı markaya yeniden bağlamak ücretsizdir. Aynı dönem içinde daha önce o markadan bağlantısını kestiğiniz bir sosyal hesabı yeniden bağlamak, mevcut yuvasını yeniden kullanır: yuva connectionsReleased kapsamından çıkarak yeniden connectionsActive kapsamına girer ve faturalandırılabilir connections değeri değişmez. Her marka ve hesap çifti için bir yuva tutulur; bu nedenle farklı bir sosyal hesap yeni bir yuva gerektirir ve aynı hesabın farklı bir markaya bağlanması da yeni bir yuva gerektirir.
• Bir markayı arşivlemek, markaya ait tüm bağlantıları keser; dolayısıyla arşivleme sırasında önce bu çağrıyı yapmanız gerekmez. Bu durumda da yuvalar dönem sonuna kadar tutulur; serbest bırakma yöntemi fark yaratmaz.

Yazma işlemi: canlı hesap üzerinde yürütülmemiştir. Gösterilen istek ve yanıt, API şemasından oluşturulmuştur.