L'API commentaires LinkedIn : ce qu'elle permet à une application de faire
PostCat AI n'est pas affilié à LinkedIn.
L'API commentaires LinkedIn est l'API socialActions/comments. Elle permet à une application d'écrire et de lire des commentaires sur des publications. Elle propose des méthodes pour récupérer un commentaire, récupérer les commentaires d'une publication ou d'un commentaire, puis créer, modifier et supprimer un commentaire. Avant qu'une application puisse récupérer des données ou accéder aux données d'un membre, elle doit être autorisée et authentifiée.
Artem Luko
Fondateur de PostCat AI
0+
abonnés sur LinkedIn
Il a fait grimper sa portée sur LinkedIn post après post. PostCat AI, c'est tout ce qu'il a appris, au même endroit.
Voir comment faireCe que l'API commentaires LinkedIn permet à une application de faire
La documentation de LinkedIn liste ces méthodes :
- Get a Comment
- Batch Get a Collection of Comments
- Get Comments on Shares
- Get Comments on Comments
- Create a Comment
- Edit a Comment
- Delete a Comment
Un commentaire unique se lit avec une requête GET vers https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments/{commentId}. Plusieurs commentaires peuvent être lus en un seul appel avec .../comments/ids=List({commentId}). Les commentaires d'une publication proviennent d'une requête GET vers https://api.linkedin.com/rest/socialActions/{shareUrn|ugcPostUrn|commentUrn}/comments.
Où trouver la documentation
La référence de l'API se trouve sur Microsoft Learn, où LinkedIn publie sa documentation pour les développeurs. Commencez par Microsoft Learn : Comments API. Le centre d'aide LinkedIn ne couvre que ce que font les membres sur le site et dans l'application, pas l'API.
Les autorisations dont vous avez besoin
Chaque autorisation détermine ce qu'une application peut faire. Le tableau ci-dessous conserve la formulation de la documentation de LinkedIn.
| Autorisation | Ce qu'elle permet à une application de faire | Accès |
|---|---|---|
| w_member_social | Permet à une application de publier, de commenter et d'aimer des publications au nom d'un membre authentifié | Listée sous Share on LinkedIn dans le tableau des autorisations ouvertes |
| w_member_social_feed | Permet à une application de créer, modifier et supprimer des commentaires et des réactions sur des publications au nom du membre | Autorisation membre (3-legged) pour l'API Community Management |
| r_member_social_feed | Permet à une application de récupérer les publications, réactions et mentions j'aime au nom d'un membre authentifié | Restreinte, accordée à certains développeurs seulement |
| w_organization_social_feed | Permet à une application de publier, commenter et réagir au nom d'une organisation | Restreinte aux organisations pour lesquelles le membre a l'un des rôles de page entreprise |
Les tableaux d'autorisations ne sont pas identiques dans toutes les versions de l'API. Vérifiez la version que vous comptez utiliser avant de vous fier à une ligne.
Champs des commentaires : auteur, message et réponses
Chaque commentaire a un auteur, c'est-à-dire l'URN de la personne qui commente. Le champ auteur est obligatoire. Un auteur urn:li:person crée un commentaire personnel, le membre étant l'éditeur. Un auteur urn:li:organization ou urn:li:organizationBrand crée un commentaire d'organisation qu'un membre rédige au nom de l'entité.
Le champ message est un texte obligatoire, et il peut inclure des liens vers des personnes et des organisations. Un contenu comme une image est facultatif.
Une réponse est un commentaire imbriqué. Son champ parentComment contient l'URN du commentaire parent. Ce champ n'est pas disponible pour les commentaires de premier niveau.
Pour modifier un commentaire, la requête utilise l'en-tête X-RestLi-Method: PARTIAL_UPDATE et un patch qui définit le texte du message. Delete a Comment fait partie des méthodes listées.
Activer ou désactiver les commentaires
Les commentaires d'une publication s'activent et se désactivent par une autre API, l'API Social Metadata. Réglez commentsState sur CLOSED pour désactiver les commentaires, et sur OPEN pour les réactiver. Désactiver les commentaires supprime tous les commentaires existants du fil. Les réactions restent en place. Réactiver les commentaires permet à nouveau aux personnes d'écrire des commentaires dans le fil.
L'API Social Metadata n'accepte que les URN de fil. Elle rejette toute écriture qui utilise un URN de commentaire. Pour créer et récupérer un commentaire, utilisez l'API Comments. Les compteurs récapitulatifs sont commentSummary.count, qui inclut les réponses, et commentSummary.topLevelCount, qui les exclut.
Commenter à la main sur LinkedIn
Si vous voulez tester le fonctionnement d'un commentaire avant d'appeler l'API, faites-le d'abord manuellement. Les étapes suivent LinkedIn Help : Comment on posts and reply to a comment.
- Cliquez sur Comment sous la publication, ou cliquez sur la zone de texte qui indique Add a comment.
- Tapez votre commentaire.
- Au besoin, cliquez sur l'icône Emoji, l'icône GIF ou l'icône Image.
- Cliquez sur Comment.
Pour répondre, cliquez sur Reply sous un commentaire, ou cliquez sur la zone de texte qui indique Add a reply, tapez votre réponse, puis cliquez sur Reply. Les membres peuvent aussi limiter les commentaires aux seules relations, ce qui empêche les personnes qui ne sont pas des relations de premier degré de commenter.
Pour modifier votre propre commentaire, cliquez sur l'icône More à droite du commentaire, cliquez sur l'icône Edit, effectuez les modifications, puis cliquez sur Save Changes. Le commentaire affiche alors (edited) au-dessus. Les étapes suivent LinkedIn Help : Edit a comment.
Pour commencer
Lisez la référence de la version de l'API que vous comptez utiliser, car les lignes d'autorisations changent d'une version à l'autre. Commencez par un seul appel de lecture sur une publication que vous possédez. N'ajoutez des écritures qu'une fois que les lectures renvoient ce que vous attendez.
Ce que les pages d'aide que nous avons lues ne disent pas
Les pages d'aide que nous avons lues ne précisent pas :
- Les limites de débit et les quotas de l'API.
- Les frais ou la tarification de l'accès à l'API.
- Comment créer une application, comment obtenir l'accès au Marketing Developer Platform ou à Community Management, combien de temps dure l'approbation, et si les développeurs individuels sont admissibles.
- Si une application sans droits d'administrateur peut lire les commentaires sur les publications d'autres membres.
- Le format de requête pour Delete a Comment, la pagination et les limites de comptage, ainsi que la version actuelle de l'API.
PostCat AI et les commentaires
PostCat AI est un produit indépendant, qui n'est ni exploité ni approuvé par LinkedIn. Il répond aux commentaires sous les publications qu'il diffuse, après validation ou de lui-même, et il ne fonctionne que via l'API officielle de LinkedIn. Ses tarifs figurent sur la page tarifs.
Sources
- Comments API - LinkedIn (learn.microsoft.com)
- LinkedIn Help: Comment on posts and reply to a comment
- LinkedIn Help: Edit comments in your LinkedIn feed
- Getting Access to LinkedIn APIs - LinkedIn (learn.microsoft.com)
- Increasing Access - LinkedIn (learn.microsoft.com)
- Community Management - Overview - LinkedIn (learn.microsoft.com)
- Migration Guide for Community Management API - LinkedIn (learn.microsoft.com)
- Integration Requirements for Community Management - LinkedIn (learn.microsoft.com)
- Social Metadata API - LinkedIn (learn.microsoft.com)
- Posts API - LinkedIn (learn.microsoft.com)


