Elenca le connessioni di un brand

Elenca gli account social collegati a un singolo brand. Il valore id di ogni riga è l'ID della connessione: il valore che passi in connectedChannelIds quando vuoi indirizzare un post a canali specifici, il valore accettato da disconnect e il valore socialConnectedChannelId richiesto da insights.

Caso d'uso: visualizzare il selettore dei canali. Prima di mostrare un editor di post, leggi questo elenco e proponi un interruttore per ogni riga, con un'etichetta contenente displayName e platform. Un brand con un array socialConnected vuoto non ha canali su cui pubblicare; indirizza invece l'utente a un link di connessione.

Caso d'uso: confermare che una connessione sia stata completata. Dopo che l'utente torna dal flusso di connessione ospitato con status=success, interroga periodicamente questo endpoint finché non compare la riga il cui valore id corrisponde al valore connectedAccountId nell'URL di ritorno. Le connessioni vengono create in modo asincrono, quindi attendi qualche secondo ed effettua un paio di nuovi tentativi prima di mostrare un errore.

Note.

• platform assume uno dei seguenti valori: FACEBOOK, INSTAGRAM, TWITTER (X), LINKEDIN, PINTEREST.
• id è l'UUID della connessione ed è il valore richiesto da ogni endpoint Social che accetta una connessione. referenceId è l'identificatore dell'account assegnato dalla piattaforma stessa — l'ID di una Pagina Facebook, l'ID di un account aziendale Instagram — utile per trovare corrispondenze con i record che conservi al di fuori di ListingsAPI, ma mai accettato come input qui.
• archived: true con un timestamp archivedAt indica che la connessione non è più disponibile, perché qualcuno l'ha scollegata, perché il brand è stato archiviato oppure perché la piattaforma ha revocato il token. Un post indirizzato a un canale archiviato fallisce con SY95045.
• listingConnectedAccountId viene impostato solo quando lo stesso account è collegato anche sul lato Listings; vale null per una connessione solo Social.
• Per la pubblicazione viene utilizzata una sola connessione per piattaforma per brand. Collegare nuovamente la stessa piattaforma allo stesso brand sostituisce il canale precedente anziché aggiungerne un secondo.
• Per vedere l'utilizzo delle connessioni nell'intero account rispetto al tuo limite massimo, anziché i canali di un singolo brand, chiama GET /social/limits.