Lister les connexions d'une marque

Liste les comptes sociaux rattachés à une marque. Le champ id de chaque ligne est l'identifiant de connexion : c'est la valeur que vous transmettez dans connectedChannelIds lorsque vous souhaitez qu'une publication soit diffusée sur des canaux précis, la valeur qu'accepte déconnecter et le socialConnectedChannelId requis par statistiques.

Cas d'utilisation : afficher le sélecteur de canaux. Avant d'afficher un éditeur de publication, consultez cette liste et proposez un bouton à bascule par ligne, libellé avec displayName et platform. Une marque dont le tableau socialConnected est vide ne dispose d'aucun canal de publication ; dirigez plutôt l'utilisateur vers un lien de connexion.

Cas d'utilisation : confirmer qu'une connexion a bien été établie. Lorsque l'utilisateur revient du parcours de connexion hébergé avec status=success, interrogez régulièrement cet endpoint jusqu'à ce que la ligne dont le champ id correspond au connectedAccountId de l'URL de retour apparaisse. Les connexions sont créées de manière asynchrone ; attendez donc quelques secondes et effectuez deux nouvelles tentatives avant d'afficher une erreur.

Remarques.

• platform prend l'une des valeurs suivantes : FACEBOOK, INSTAGRAM, TWITTER (X), LINKEDIN, PINTEREST.
• id est l'UUID de la connexion et la valeur attendue par chaque endpoint Social qui prend une connexion en paramètre. referenceId est l'identifiant du compte propre à la plateforme — un identifiant de Page Facebook, un identifiant de compte professionnel Instagram — utile pour établir une correspondance avec les enregistrements que vous conservez en dehors de ListingsAPI, mais jamais accepté en entrée ici.
• archived: true accompagné d'un horodatage archivedAt signifie que la connexion n'existe plus, soit parce que quelqu'un l'a déconnectée, soit parce que la marque a été archivée, soit parce que la plateforme a révoqué le jeton. Une publication ciblant un canal archivé échoue avec SY95045.
• listingConnectedAccountId n'est défini que lorsque le même compte est également lié côté Listings ; sa valeur est null pour une connexion uniquement Social.
• Une seule connexion par plateforme et par marque est utilisée pour la publication. Connecter de nouveau la même plateforme à la même marque remplace le canal précédent au lieu d'en ajouter un second.
• Pour consulter le nombre de connexions utilisées à l'échelle de votre compte par rapport à votre plafond, plutôt que les canaux d'une seule marque, appelez GET /social/limits.