Bir markanın bağlantılarını listeleyin

Tek bir markaya bağlı sosyal medya hesaplarını listeler. Her satırdaki id, bağlantı kimliğidir: bir gönderinin belirli kanallarda yayımlanmasını istediğinizde connectedChannelIds içinde ilettiğiniz, bağlantıyı kesme işleminin aldığı ve istatistikler işleminin gerektirdiği socialConnectedChannelId olarak kullanılan değerdir.

Kullanım senaryosu: kanal seçiciyi görüntüleme. Gönderi oluşturma arayüzünü göstermeden önce bu listeyi okuyun ve her satır için displayName ve platform ile etiketlenmiş bir açma/kapatma düğmesi sunun. socialConnected dizisi boş olan bir markanın yayın yapabileceği bir kanal yoktur; bu durumda kullanıcıyı bir bağlantı kurma bağlantısına yönlendirin.

Kullanım senaryosu: bağlantının oluşturulduğunu doğrulama. Kullanıcı, barındırılan bağlantı kurma akışından status=success ile döndükten sonra, id değeri dönüş URL'sindeki connectedAccountId ile eşleşen satır görünene kadar bu uç noktayı düzenli aralıklarla sorgulayın. Bağlantılar eşzamansız olarak oluşturulur; bu nedenle hata göstermeden önce birkaç saniye bekleyin ve birkaç kez yeniden deneyin.

Notlar.

• platform, FACEBOOK, INSTAGRAM, TWITTER (X), LINKEDIN, PINTEREST değerlerinden biridir.
• id, bağlantının UUID'sidir ve bağlantı kabul eden tüm Social uç noktalarının beklediği değerdir. referenceId, platformun kendi hesap tanımlayıcısıdır — bir Facebook Sayfa Kimliği veya Instagram işletme hesabı kimliği — ve ListingsAPI dışında tuttuğunuz kayıtlarla eşleştirme yapmak için yararlıdır, ancak burada hiçbir zaman girdi olarak kabul edilmez.
• archivedAt zaman damgasıyla birlikte archived: true, birinin bağlantıyı kesmesi, markanın arşivlenmesi veya platformun belirteci iptal etmesi nedeniyle bağlantının artık mevcut olmadığı anlamına gelir. Arşivlenmiş bir kanalı hedefleyen gönderi, SY95045 ile başarısız olur.
• listingConnectedAccountId yalnızca aynı hesap Listings tarafında da bağlıysa ayarlanır; yalnızca Social tarafında bulunan bir bağlantı için değeri null olur.
• Yayın yapmak için her markada platform başına yalnızca bir bağlantı kullanılır. Aynı platformu aynı markaya yeniden bağlamak, ikinci bir kanal eklemek yerine önceki kanalın yerini alır.
• Tek bir markanın kanalları yerine hesabınızın tamamındaki bağlantı kullanımını üst sınırınıza göre görmek için GET /social/limits çağrısını yapın.