Obtenir une publication sur les réseaux sociaux

Récupère une publication à partir de son UUID, avec le contenu rédigé, la planification effective et une entrée par canal ciblé décrivant ce qui s’est réellement passé sur cette plateforme. C’est le point de terminaison que vous interrogez périodiquement après avoir créé une publication.

Cas d’utilisation : vérification après publication. La publication est asynchrone, donc POST /social/posts vous indique uniquement que la publication a été acceptée. Interrogez périodiquement ce point de terminaison avec la valeur socialPostId renvoyée et consultez connectedChannels[] : status: "SUCCESS" avec une valeur liveLink signifie que la publication est en ligne sur ce canal, tandis que status: "ERROR" avec error renseigné indique qu’elle ne l’est pas et en précise la raison. Arrêtez les interrogations périodiques dès qu’aucun canal n’est encore à l’état SCHEDULED.

Cas d’utilisation : montrer au client où sa publication a été diffusée. Affichez chaque connectedChannels[].liveLink sous forme de lien externe pour que l’utilisateur puisse ouvrir la publication directement sur la plateforme, et affichez error au niveau des canaux pour lesquels la publication a échoué, au lieu de ramener l’ensemble de la publication à un seul état d’échec.

Lire les champs d’état

Il existe deux niveaux d’état, qui répondent à des questions différentes.

Une publication peut afficher l’état global PUBLISHED alors qu’un canal reste à l’état ERROR. Basez toujours l’affichage sur connectedChannels[] ; le champ status au niveau de la publication est un résumé.

Remarques.

• globalPostSchedule est l’instant de publication effectif en UTC. Si vous avez planifié la publication avec scheduleDate + scheduleTime, il s’agit de l’instant obtenu en appliquant le fuseau horaire de la marque à ces valeurs — une vérification utile pour confirmer que le fuseau horaire était bien celui attendu.
• error est un message lisible que vous pouvez afficher à un client en toute sécurité ; reason est le libellé interne plus court qui lui correspond. Aucun des deux ne contient de jetons de plateforme ni d’identifiants de trace.
• connectedChannels[].id est l’UUID de connexion issu des connexions de la marque, ainsi que la valeur requise par insights pour socialConnectedChannelId.
• Un canal affichant archived: true a été déconnecté après la création de la publication. La publication ne sera pas diffusée sur ce canal ; consultez disconnect.
• Un canal bloqué à l’état ERROR après l’expiration d’une autorisation nécessite un nouveau lien de connexion, et non une nouvelle tentative de publication.
• Pour obtenir les chiffres d’engagement plutôt que l’état de diffusion, appelez GET /social/posts/{postId}/insights.
• Pour répertorier les publications d’une marque plutôt que d’en récupérer une seule, utilisez GET /social/brands/{brandId}/posts.