> ## Documentation Index
> Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# API LinkedIn

> Options de publication à l'aide de l'API LinkedIn

L'API LinkedIn a les exigences et restrictions suivantes :

<ul class="custom-bullets">
  <li>Le champ `post` accepte jusqu'à 3 000 caractères.</li>

  <li>
    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.
  </li>

  <li>Les hashtags sont cliquables sur LinkedIn. Utilisez le symbole # pour spécifier un hashtag LinkedIn.</li>

  <li>
    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](/apis/post/post) pour plus de détails.
  </li>

  <li>
    Le traitement des vidéos LinkedIn prend plusieurs minutes. Attendez avant d'utiliser l'URL de partage
    ou d'obtenir les statistiques vidéo.
  </li>

  <li>LinkedIn limite à 150 publications par jour et par compte LinkedIn.</li>
  <li>La publication sur des LinkedIn Groups n'est pas prise en charge.</li>

  <li>
    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: ""`.
  </li>

  <li>Vous pouvez associer soit une page entreprise, soit un compte LinkedIn personnel.</li>

  <li>
    Consultez [LinkedIn Media Guidelines](/media-guidelines/linkedin) et [LinkedIn
    Authorization](/dashboard/connect-social-accounts/linkedin) pour plus d'informations.
  </li>
</ul>

<Warning>
  Vous devez être « Super Admin » ou « Content Admin » pour connecter une page entreprise LinkedIn.{" "}
</Warning>

## Publier sur LinkedIn

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

```json LinkedIn Post theme={"system"}
{
  "post": "The best LinkedIn post ever #best https://www.linkedin.com", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["linkedin"]
}
```

## Options LinkedIn

Vous pouvez définir des options supplémentaires pour une publication en utilisant le paramètre `linkedInOptions`.

```json LinkedIn Options theme={"system"}
{
  "linkedInOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"],
    "disableShare": true,
    "targeting": {
      "countries": ["US", "IN", "DE", "GB"],
      "seniorities": ["Senior", "VP"],
      "degrees": ["Master of Digital Design", "Bachelor of Engineering"],
      "fieldsOfStudy": ["Consumer Economics", "Computer Games and Programming Skills"],
      "industries": ["Telecommunications Carriers", "Banking"],
      "jobFunctions": ["Information Technology", "Entrepreneurship"],
      "staffCountRanges": ["size_51_to_200", "size_5001_to_10000"]
    },
    "thumbNail": "https://example.com/thumbnail.jpg",
    "title": "Sample PPTX",
    "titles": ["This is an amazing video", "😃 here is the next one"],
    "visibility": "public"
  }
}
```

Les options LinkedIn sont des champs facultatifs qui peuvent être utilisés pour contrôler la publication.

<ParamField body="altText" type="array of strings">
  Texte alternatif des images pour l'accessibilité et les lecteurs d'écran.

  Consultez [Texte alternatif LinkedIn](/apis/post/social-networks/linkedin#alternative-text) pour plus d'informations.
</ParamField>

<ParamField body="disableShare" type="boolean" default={false}>
  Désactive la possibilité pour les utilisateurs de repartager la publication LinkedIn.

  Consultez [LinkedIn Disable Share](/apis/post/social-networks/linkedin#disable-share) pour plus d'informations.
</ParamField>

<ParamField body="targeting" type="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](/apis/post/social-networks/linkedin#audience-targeting) pour plus d'informations.
</ParamField>

<ParamField body="thumbNail" type="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](/apis/post/social-networks/linkedin#video-thumbnail) pour plus d'informations.
</ParamField>

<ParamField body="title" type="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](/apis/post/social-networks/linkedin#documents) pour plus d'informations.
</ParamField>

<ParamField body="titles" type="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](/apis/post/social-networks/linkedin#media-titles) pour plus d'informations.
</ParamField>

<ParamField body="visibility" type="string" default="public">
  La visibilité de la publication.

  Valeurs : `public`, `connections` ou `loggedin`.

  Consultez [Visibilité des publications LinkedIn](/apis/post/social-networks/linkedin#post-visibility) pour plus d'informations.
</ParamField>

## 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`.

```json LinkedIn Alt Text theme={"system"}
{
  "linkedInOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts
  }
}
```

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.

<Warning>
  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.
</Warning>

Utilisez l'objet `targeting` dans l'objet `linkedInOptions` :

```json LinkedIn Audience Targeting theme={"system"}
{
  "linkedInOptions": {
    "targeting": {
      "countries": ["US", "IN", "DE", "GB"],
      "seniorities": ["Senior", "VP"],
      "degrees": ["Master of Digital Design", "Bachelor of Engineering"],
      "fieldsOfStudy": ["Consumer Economics", "Computer Games and Programming Skills"],
      "industries": ["Telecommunications Carriers", "Banking"],
      "jobFunctions": ["Information Technology", "Entrepreneurship"],
      "staffCountRanges": ["size_51_to_200", "size_5001_to_10000"]
    }
  }
}
```

Les options de ciblage disponibles sont listées dans les fichiers JSON suivants :

<ul class="custom-bullets">
  <li>[LinkedIn Countries](https://logo.ayrshare.com/data/linkedin/countries.json)</li>
  <li>[LinkedIn Seniorities](https://logo.ayrshare.com/data/linkedin/seniorities.json)</li>
  <li>[LinkedIn Degrees](https://logo.ayrshare.com/data/linkedin/degrees.json)</li>
  <li>[LinkedIn Fields of Study](https://logo.ayrshare.com/data/linkedin/fieldsOfStudy.json)</li>
  <li>[LinkedIn Industries](https://logo.ayrshare.com/data/linkedin/industries.json)</li>
  <li>[LinkedIn Job Functions](https://logo.ayrshare.com/data/linkedin/jobFunctions.json)</li>

  <li>
    [LinkedIn Staff Count Ranges](https://logo.ayrshare.com/data/linkedin/staffCountRanges.json)
  </li>
</ul>

## Renouvellement de l'autorisation

LinkedIn doit être réautorisé *tous les ans* via la page Social Accounts.

<ul class="custom-bullets">
  <li>
    Une notification par e-mail et par webhook (action sociale) sera envoyée 15 jours avant l'expiration
    de l'autorisation.
  </li>

  <li>
    La date de renouvellement requise et le nombre de jours restants peuvent être récupérés depuis le
    point de terminaison [/user](/apis/user/overview).
  </li>

  <li>
    L'utilisateur verra sur sa page d'association de compte social une alerte et un bouton de renouvellement 30 jours
    avant l'expiration.
  </li>
</ul>

## Limites de caractères

Consultez [LinkedIn Character Limits](/help-center/technical-support/character_limits#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` :

```json LinkedIn Disable Share theme={"system"}
{
  "linkedInOptions": {
    "disableShare": true
  }
}
```

## 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 :

```json LinkedIn Document Post theme={"system"}
{
  "post": "What a great document",
  "platforms": ["linkedin"],
  "linkedInOptions": {
    "title": "Sample PPTX" // optional. If not specified, the file name used.
  },
  "mediaUrls": ["https://scholar.harvard.edu/files/torman_personal/files/samplepptx.pptx"]
}
```

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.

<Warning>
  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.
</Warning>

Consultez les [règles importantes](/testing/post-verification#mentions) 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,

<ul class="custom-bullets">
  <li>
    Le profil entreprise LinkedIn d'Ayrshare est
    [https://www.linkedin.com/company/ayrshare](https://www.linkedin.com/company/ayrshare) et le
    handle utilisé serait *@ayrshare*.
  </li>

  <li>
    Le profil entreprise LinkedIn de Zara est
    [https://www.linkedin.com/company/zara-sa/](https://www.linkedin.com/company/zara-sa/) et le
    handle utilisé serait *@zara-sa*.
  </li>
</ul>

```json LinkedIn Mention theme={"system"}
{
  "post": "The best social media API @ayrshare ever!",
  "platforms": ["linkedin"]
}
```

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

```json LinkedIn Mention theme={"system"}
{
  "post": "The best social media API @[John Smith] and @ava_smith ever!",
  "platforms": ["linkedin"]
}
```

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

```json LinkedIn Media Titles theme={"system"}
{
  "linkedInOptions": {
    "titles": ["This is an amazing video", "😃 here is the next one"] // Array of Alt Texts
  }
}
```

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.

```json LinkedIn Multi Image Post theme={"system"}
{
  "mediaUrls": ["https://url1", ..., "https://url9"]
}
```

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.

<ul class="custom-bullets">
  <li>
    `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.
  </li>

  <li>
    `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.
  </li>

  <li>
    `loggedin` : la publication sera visible uniquement par les utilisateurs LinkedIn connectés. Disponible pour les
    pages entreprise et les comptes LinkedIn personnels connectés.
  </li>
</ul>

Utilisez le champ `visibility` dans l'objet `linkedInOptions` :

```json LinkedIn Post Visibility theme={"system"}
{
  "linkedInOptions": {
    "visibility": "public" // "public", "connections", or "loggedin"
  }
}
```

## 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`.

```json LinkedIn Video Thumbnail theme={"system"}
{
  "linkedInOptions": {
    "thumbNail": "https://octodex.github.com/images/Fintechtocat.png"
  }
}
```

Consultez ici pour plus d'[exemples d'utilisation de l'API LinkedIn](https://www.ayrshare.com/how-to-post-and-get-analytics-with-the-linkedin-api#linkedin-api-examples).
