Disconnetti una connessione

Rimuove un account social connesso dal suo brand. Il brand non viene specificato direttamente: l'ID della connessione identifica entrambi. È un'operazione irreversibile, senza una finestra di annullamento né possibilità di ripristino. Per ripristinare il canale, genera un nuovo link di connessione e chiedi all'utente di autorizzare nuovamente l'accesso.

Caso d'uso: un cliente revoca l'accesso a un canale. Quando un cliente rimuove una Pagina dalla tua gestione, disconnetti quel canale in modo che i post programmati smettano di tentare la pubblicazione su di esso. Leggi id dall'elenco delle connessioni del brand, disconnetti la connessione, quindi rileggi l'elenco per confermare.

Note.

• Il corpo della richiesta deve essere racchiuso in un oggetto input. Il campo è socialProfileConnectedChannelId: l'UUID della connessione stessa, non il valore connectedAccountId della piattaforma né l'ID del brand.
• Controlla success, non lo stato HTTP. Una connessione che appartiene a un brand diverso o che non esiste più restituisce HTTP 200 con success: false. Il payload non contiene alcun ID, quindi conserva una tua registrazione della connessione che hai chiesto di rimuovere.
• Fai attenzione ai nomi simili. Questo campo del corpo è socialProfileConnectedChannelId, con Profile al centro. L'endpoint degli insight adiacente accetta socialConnectedChannelId: lo stesso ID, con una parola in meno nel nome. I due nomi differiscono di una sola parola e nessuno dei due endpoint accetta il nome usato dall'altro.
• I post programmati non vengono annullati. Un post programmato per questo canale non verrà eliminato, ma la sua pubblicazione non riuscirà e restituirà SY95045 al momento previsto. Annullalo prima con POST /social/posts/cancel se vuoi evitare l'errore.
• I post già pubblicati rimangono online. La disconnessione rimuove la possibilità per listingsAPI di pubblicare e leggere gli insight; non elimina nulla dalla piattaforma.
• Lo slot torna nel pool al rinnovo, non quando l'operazione riesce. GET /social/limits lo mostra immediatamente con un valore usage.connectionsActive inferiore e un valore usage.connectionsReleased superiore, mentre usage.connections, il numero fatturabile a cui si applica il limite, rimane invariato fino all'inizio del periodo di fatturazione successivo. usage.connectionsReleased indica quanta capacità torna disponibile al rinnovo. Consulta Piani e componenti aggiuntivi.
• Ricollegare lo stesso account allo stesso brand è gratuito. Riconnettere un account social che hai disconnesso da quel brand in precedenza nello stesso periodo riutilizza lo slot esistente: lo slot passa da connectionsReleased a connectionsActive e il valore fatturabile connections non cambia. Uno slot viene riservato per ogni coppia brand-account, quindi un account social diverso richiede un nuovo slot, così come lo stesso account su un brand diverso.
• L'archiviazione di un brand disconnette tutte le sue connessioni, quindi non devi effettuare prima questa chiamata quando procedi con l'archiviazione. Anche in quel caso gli slot rimangono riservati fino alla fine del periodo: il modo in cui vengono rilasciati non fa differenza.

Operazione di scrittura: non eseguita sull'account reale. La richiesta e la risposta mostrate sono costruite a partire dallo schema dell'API.