Aller au contenu

L'API commentaires LinkedIn : ce qu'elle permet à une application de faire

6 min de lecture

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 faire

Ce 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.

AutorisationCe qu'elle permet à une application de faireAccès
w_member_socialPermet à 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_feedPermet à une application de créer, modifier et supprimer des commentaires et des réactions sur des publications au nom du membreAutorisation membre (3-legged) pour l'API Community Management
r_member_social_feedPermet à 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_feedPermet à une application de publier, commenter et réagir au nom d'une organisationRestreinte 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.

  1. Cliquez sur Comment sous la publication, ou cliquez sur la zone de texte qui indique Add a comment.
  2. Tapez votre commentaire.
  3. Au besoin, cliquez sur l'icône Emoji, l'icône GIF ou l'icône Image.
  4. 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)

Questions fréquentes

Oui. L'API socialActions/comments permet à une application d'écrire et de lire des commentaires sur des publications. Elle comporte des méthodes pour récupérer, créer, modifier et supprimer des commentaires. La référence se trouve sur Microsoft Learn.

Commencez par le prochain post de votre équipe.

Connectez les profils LinkedIn de votre équipe et lancez-vous avec un essai gratuit.