Passer au contenu principal
L’API LinkedIn a les exigences et restrictions suivantes :
  • Le champ post accepte jusqu’à 3 000 caractères.
  • LinkedIn prévisualisera automatiquement le lien dans la publication sauf si une image ou une vidéo est incluse. Dans l’exemple ci-dessus, c’est l’image qui s’affichera. Retirer l’image affichera l’aperçu du lien. Si l’aperçu du lien ne peut pas être récupéré, la publication sera tout de même diffusée et un champ linkPreviewFailed: true sera renvoyé dans la réponse /post.
  • Les hashtags sont cliquables sur LinkedIn. Utilisez le symbole # pour spécifier un hashtag LinkedIn.
  • Si vous publiez une vidéo qui ne se termine pas par une extension vidéo connue telle que mp4, utilisez le paramètre isVideo. Consultez le point de terminaison /post pour plus de détails.
  • Le traitement des vidéos LinkedIn prend plusieurs minutes. Attendez avant d’utiliser l’URL de partage ou d’obtenir les statistiques vidéo.
  • LinkedIn limite à 150 publications par jour et par compte LinkedIn.
  • La publication sur des LinkedIn Groups n’est pas prise en charge.
  • LinkedIn prend également en charge l’envoi de médias sans texte de publication. Si vous ne souhaitez pas inclure de texte, envoyez une chaîne vide post: "".
  • Vous pouvez associer soit une page entreprise, soit un compte LinkedIn personnel.
  • Consultez LinkedIn Media Guidelines et LinkedIn Authorization pour plus d’informations.
Vous devez être « Super Admin » ou « Content Admin » pour connecter une page entreprise LinkedIn.

Publier sur LinkedIn

JSON pour une publication de base avec un lien et une image sur LinkedIn :
LinkedIn Post

Options LinkedIn

Vous pouvez définir des options supplémentaires pour une publication en utilisant le paramètre linkedInOptions.
LinkedIn Options
Les options LinkedIn sont des champs facultatifs qui peuvent être utilisés pour contrôler la publication.
altText
array of strings
Texte alternatif des images pour l’accessibilité et les lecteurs d’écran.Consultez Texte alternatif LinkedIn pour plus d’informations.
disableShare
boolean
défaut:false
Désactive la possibilité pour les utilisateurs de repartager la publication LinkedIn.Consultez LinkedIn Disable Share pour plus d’informations.
targeting
object
Ciblez vos publications organiques vers des groupes spécifiques selon les pays, l’industrie, le titre du poste, et plus encore.Requiert au moins 300 abonnés dans l’audience ciblée.Consultez Ciblage d’audience LinkedIn pour plus d’informations.
thumbNail
string
La miniature d’une vidéo. Doit être PNG ou JPG, avec les mêmes dimensions que la vidéo, moins de 10 Mo. L’URL doit se terminer par .png ou .jpg.Consultez Miniature vidéo LinkedIn pour plus d’informations.
title
string
Le titre d’un document lors de la publication de fichiers PPT, PPTX, DOC, DOCX ou PDF. Longueur maximale : 400 caractères.Si non spécifié, le nom de fichier est utilisé.Consultez Documents LinkedIn pour plus d’informations.
titles
array of strings
Titre ou légendes de médias pour les images ou vidéos LinkedIn.Chaque titre correspond à une URL de média dans l’ordre.Consultez Titres des médias LinkedIn pour plus d’informations.
visibility
string
défaut:"public"
La visibilité de la publication.Valeurs : public, connections ou loggedin.Consultez Visibilité des publications LinkedIn pour plus d’informations.

Texte alternatif

Ajoutez du texte alternatif LinkedIn, également appelé alt text LinkedIn, à une image LinkedIn. L’alt text LinkedIn est une fonctionnalité d’accessibilité utilisée pour fournir des informations supplémentaires aux utilisateurs et aux lecteurs d’écran. LinkedIn ne prend pas en charge l’altText sur les vidéos ni les documents. Utilisez altText dans l’objet linkedInOptions.
LinkedIn Alt Text
Chaque alt text doit correspondre à une image du tableau mediaUrls. L’alt text est appliqué à chaque image dans l’ordre.

Ciblage d’audience

LinkedIn vous permet de cibler vos publications organiques vers des groupes d’utilisateurs spécifiques. Vous pouvez cibler par pays, industrie, titre de poste, et plus encore.
Le ciblage LinkedIn nécessite au moins 300 abonnés dans l’audience ciblée. Par exemple, si vous avez 400 abonnés et ciblez uniquement les utilisateurs du pays US, mais que seuls 200 de vos abonnés sont aux US, le ciblage échouera car l’audience est trop petite.
Utilisez l’objet targeting dans l’objet linkedInOptions :
LinkedIn Audience Targeting
Les options de ciblage disponibles sont listées dans les fichiers JSON suivants :

Renouvellement de l’autorisation

LinkedIn doit être réautorisé tous les ans via la page Social Accounts.
  • Une notification par e-mail et par webhook (action sociale) sera envoyée 15 jours avant l’expiration de l’autorisation.
  • La date de renouvellement requise et le nombre de jours restants peuvent être récupérés depuis le point de terminaison /user.
  • L’utilisateur verra sur sa page d’association de compte social une alerte et un bouton de renouvellement 30 jours avant l’expiration.

Limites de caractères

Consultez LinkedIn Character Limits pour plus d’informations.

Désactiver le partage

Vous pouvez désactiver la possibilité pour les utilisateurs de repartager la publication LinkedIn en définissant le champ disableShare sur true dans l’objet linkedInOptions :
LinkedIn Disable Share

Documents

Utilisez l’API pour publier un document sur LinkedIn. Les formats de fichiers pris en charge incluent : PPT, PPTX, DOC, DOCX et PDF. Assurez-vous que le document fait moins de 100 Mo et ne dépasse pas 300 pages. Voici un exemple de code montrant comment publier un document PPTX avec un titre :
LinkedIn Document Post
L’URL du média fournie doit se terminer par une extension de document connue : ppt, pptx, doc, docx ou pdf.

Mentions LinkedIn

Vous pouvez mentionner d’autres organisations LinkedIn, c’est-à-dire des pages entreprises, ou des profils de membres, c’est-à-dire des pages de profils individuels, dans vos publications. Ayrshare tente de résoudre la @mention en effectuant une recherche sur le handle. Si la @mention n’est pas trouvée, le @ sera retiré de la publication car LinkedIn n’accepte pas les publications avec des mentions non résolues. Les profils LinkedIn individuels ne peuvent pas être mentionnés.
Si une mention dans une publication LinkedIn ne peut être résolue (en raison des paramètres de confidentialité, de restrictions de compte ou d’autres limitations de la plateforme), LinkedIn peut échouer à afficher toutes les mentions de cette publication en tant que liens cliquables. Il s’agit d’un comportement de la plateforme LinkedIn et non d’un problème d’API. Pour éviter cela, assurez-vous que tous les utilisateurs et organisations mentionnés autorisent les mentions de votre organisation, ou envisagez de publier les mentions séparément pour isoler d’éventuelles mentions problématiques.
Consultez les règles importantes sur les mentions.

Profils d’organisation

Mentionnez un autre handle d’organisation LinkedIn en ajoutant @handle dans le texte de la publication. Le @handle est le nom de l’entreprise ou de l’organisation. Vous pouvez mentionner dans les publications, commentaires et réponses aux commentaires. Par exemple,
LinkedIn Mention

Profils de membres

Mentionnez un autre profil de membre LinkedIn en ajoutant @vanity_name ou @[John Smith] dans le texte de la publication.
  1. @vanity_name est le nom vanity du profil membre. Par exemple, dans l’URL de profil du membre https://www.linkedin.com/in/vanity_name/, le nom vanity est vanity_name.
  2. @[John Smith] est le nom complet de la personne. Par exemple, si le nom complet de la personne est John Smith, la mention serait @[John Smith].
Vous pouvez mentionner dans les publications, commentaires et réponses aux commentaires.
LinkedIn Mention
Dans l’exemple ci-dessus, John Smith et Ava Smith seront mentionnés dans la publication — le premier par son nom complet et le second par son nom vanity. Remarques importantes :
  1. Vous devez avoir une page entreprise LinkedIn connectée à votre compte Ayrshare pour pouvoir mentionner des profils de membres. Si vous connectez votre propre compte LinkedIn personnel, vous ne pourrez pas mentionner d’autres profils personnels.
  2. LinkedIn n’autorise que la mention de personnes qui suivent votre organisation / page entreprise.

Titres des médias

Ajoutez un titre ou des légendes de médias aux images ou vidéos LinkedIn. Utilisez titles dans l’objet linkedInOptions.
LinkedIn Media Titles
Chaque titre doit correspondre à une image ou vidéo du tableau mediaUrls. Le titre est appliqué à chaque image ou vidéo dans l’ordre.

Publications multi-images

Vous pouvez publier jusqu’à 9 URLs d’images dans mediaUrls sur LinkedIn.
LinkedIn Multi Image Post
LinkedIn ne prend pas encore en charge les carrousels d’images pour les publications organiques.

Visibilité des publications

LinkedIn vous permet de contrôler la visibilité de vos publications. Vous pouvez définir la visibilité sur public, connexions uniquement ou utilisateurs connectés uniquement. Si aucune visibilité n’est spécifiée, la publication sera « public » et visible par tous les utilisateurs LinkedIn.
  • public : la publication sera visible par tous les utilisateurs LinkedIn. Disponible pour les pages entreprise et les comptes LinkedIn personnels connectés. Valeur par défaut si aucune visibilité n’est spécifiée.
  • connections : la publication sera visible par le réseau du 1er degré du propriétaire (user profile). Disponible uniquement pour les comptes LinkedIn personnels connectés.
  • loggedin : la publication sera visible uniquement par les utilisateurs LinkedIn connectés. Disponible pour les pages entreprise et les comptes LinkedIn personnels connectés.
Utilisez le champ visibility dans l’objet linkedInOptions :
LinkedIn Post Visibility

Autorisations de publication vidéo

Sur LinkedIn, seuls les utilisateurs disposant d’autorisations spécifiques peuvent publier des vidéos sur les pages entreprise :
  1. Utilisateurs avec des autorisations Admin.
  2. Utilisateurs avec des autorisations Direct Sponsored Content (DSC).
Les Content Administrators ne peuvent pas publier de vidéos sur les pages entreprise LinkedIn.

Miniature vidéo

Définissez une miniature LinkedIn pour une vidéo. Envoyez une URL distante d’un fichier PNG ou JPG des mêmes dimensions que la vidéo et de moins de 10 Mo. L’URL doit se terminer par .png ou .jpg. Utilisez thumbNail dans l’objet linkedInOptions.
LinkedIn Video Thumbnail
Consultez ici pour plus d’exemples d’utilisation de l’API LinkedIn.