Mencantumkan koneksi suatu merek

Mencantumkan akun media sosial yang terhubung ke satu merek. id pada setiap baris adalah ID koneksi: nilai yang Anda berikan dalam connectedChannelIds saat ingin mengirim postingan ke kanal tertentu, nilai yang diterima oleh pemutusan koneksi, dan socialConnectedChannelId yang diperlukan oleh wawasan.

Kasus penggunaan: menampilkan pemilih kanal. Sebelum menampilkan editor postingan, baca daftar ini dan sediakan satu tombol alih untuk setiap baris, dengan label displayName dan platform. Merek dengan array socialConnected kosong tidak memiliki tujuan untuk memublikasikan postingan; arahkan pengguna ke tautan koneksi.

Kasus penggunaan: memastikan koneksi telah terbentuk. Setelah pengguna kembali dari alur koneksi yang dihosting dengan status=success, panggil endpoint ini secara berkala hingga muncul baris yang nilai id-nya cocok dengan connectedAccountId pada URL pengembalian. Koneksi dibuat secara asinkron, jadi tunggu beberapa detik dan lakukan beberapa percobaan ulang sebelum menampilkan kesalahan.

Catatan.

• platform adalah salah satu dari FACEBOOK, INSTAGRAM, TWITTER (X), LINKEDIN, PINTEREST.
• id adalah UUID koneksi dan merupakan nilai yang diperlukan oleh setiap endpoint Social yang menerima koneksi. referenceId adalah pengenal akun milik platform itu sendiri — ID Halaman Facebook, ID akun bisnis Instagram — yang berguna untuk dicocokkan dengan catatan yang Anda simpan di luar ListingsAPI, tetapi tidak pernah diterima sebagai masukan di sini.
• archived: true dengan stempel waktu archivedAt berarti koneksi sudah tidak ada, baik karena seseorang telah memutuskan koneksinya, karena merek diarsipkan, maupun karena platform mencabut token. Postingan yang menargetkan kanal yang diarsipkan akan gagal dengan SY95045.
• listingConnectedAccountId hanya ditetapkan jika akun yang sama juga ditautkan di sisi Listings; nilainya adalah null untuk koneksi yang hanya digunakan di Social.
• Hanya satu koneksi per platform per merek yang digunakan untuk publikasi. Menghubungkan platform yang sama lagi pada merek yang sama akan menggantikan kanal sebelumnya, bukan menambahkan kanal kedua.
• Untuk melihat penggunaan koneksi di seluruh akun Anda dibandingkan dengan batas maksimum Anda, alih-alih kanal milik satu merek, panggil GET /social/limits.