Déconnecter une connexion

Retire un compte social connecté de sa marque. La marque n'est pas ciblée directement : l'ID de connexion identifie à la fois la connexion et la marque. Cette opération est irréversible, sans délai d'annulation ni possibilité de retour en arrière. Pour rétablir le canal, générez un nouveau lien de connexion et demandez à l'utilisateur d'accorder à nouveau son autorisation.

Cas d'utilisation : un client révoque l'accès à un canal. Lorsqu'un client vous retire le contrôle d'une Page, déconnectez ce canal pour que les publications programmées cessent de tenter d'y être publiées. Récupérez le id dans les connexions de la marque, déconnectez le canal, puis consultez à nouveau la liste pour confirmer.

Remarques.

• Le corps de la requête doit être encapsulé dans un objet input. Le champ est socialProfileConnectedChannelId : il s'agit de l'UUID propre à la connexion, et non du connectedAccountId de la plateforme ni de l'ID de la marque.
• Vérifiez success, et non le statut HTTP. Pour une connexion qui appartient à une autre marque ou qui n'existe plus, l'appel renvoie HTTP 200 avec success: false. Le contenu de la réponse ne comporte aucun ID ; conservez donc votre propre trace de la connexion dont vous avez demandé la suppression.
• Attention aux noms très proches. Ce champ du corps de la requête est socialProfileConnectedChannelId, avec Profile au milieu. Le point de terminaison voisin consacré aux statistiques accepte socialConnectedChannelId : le même ID, avec un mot de moins. Leurs noms diffèrent d'un seul mot, et aucun des deux n'accepte le nom de l'autre.
• Les publications programmées ne sont pas annulées. Une publication programmée sur ce canal échouera au moment de sa publication avec SY95045 au lieu d'être supprimée. Annulez-la d'abord avec POST /social/posts/cancel si vous souhaitez éviter cet échec.
• Les publications déjà en ligne le restent. La déconnexion retire à listingsAPI la possibilité de publier et de consulter les statistiques ; elle ne supprime rien de la plateforme.
• L'emplacement retourne dans le pool au renouvellement, et non lorsque l'appel réussit. GET /social/limits le reflète immédiatement par une baisse de usage.connectionsActive et une hausse de usage.connectionsReleased, tandis que usage.connections — le nombre facturable auquel s'applique le plafond — reste inchangé jusqu'au début de la période de facturation suivante. usage.connectionsReleased indique la capacité qui sera de nouveau disponible au renouvellement. Consultez Forfaits et options supplémentaires.
• Reconnecter le même compte à la même marque est gratuit. Reconnecter un compte social que vous avez déconnecté de cette marque plus tôt au cours de la même période réutilise son emplacement existant : il repasse de connectionsReleased à connectionsActive et le nombre facturable connections ne change pas. Un emplacement est réservé par paire marque-compte ; un compte social différent nécessite donc un nouvel emplacement, tout comme le même compte associé à une autre marque.
• L'archivage d'une marque déconnecte toutes ses connexions ; vous n'avez donc pas besoin d'effectuer cet appel au préalable lors de l'archivage. Dans ce cas aussi, les emplacements restent réservés jusqu'à la fin de la période : la méthode de libération ne change rien.

Opération d'écriture : non exécutée sur le compte réel. La requête et la réponse présentées sont construites à partir du schéma de l'API.