Ce qu'est une publication document LinkedIn et comment LinkedIn traite le fichier

Qu'est-ce qu'une publication document LinkedIn ?

Sur LinkedIn, une publication document LinkedIn est une publication du fil dont le contenu est un fichier PDF, PowerPoint ou Word téléversé, que le fil affiche comme une série de pages que le lecteur parcourt à l'intérieur de la publication. La documentation développeur de LinkedIn en fait un type de contenu à part entière. La référence de la Posts API indique : « Creating a post with a document requires uploading a document asset to obtain a Document URN (urn:li:document:{id}) for use in the post. » Le fichier d'abord, la publication ensuite.

LinkedIn fixe les limites du fichier sur la page de la Documents API : « The file size can't exceed 100MB and 300 pages. The following file types are supported: PPT, PPTX, DOC, DOCX, and PDF. » Ces deux phrases constituent l'intégralité de la spécification que LinkedIn publie pour le fichier.

Propriété	Valeur	Source
Types de fichier	PPT, PPTX, DOC, DOCX, PDF	Documents API
Taille maximale du fichier	100MB	Documents API
Nombre maximal de pages	300	Documents API
Identifiant de l'asset	urn:li:document:{id}	Posts API
Publication organique	Prise en charge	Posts API
Publication sponsorisée	Prise en charge	Posts API
Taille ou ratio des pages	Non documenté	Aucune des deux

La dernière ligne compte pour la conception. Les pages développeur de LinkedIn ne donnent ni dimensions de page ni ratio pour les documents. Toute taille en pixels que vous lisez pour les pages d'un document vient des tests de quelqu'un, pas de la spécification de LinkedIn.

Une publication document LinkedIn est-elle la même chose qu'un carrousel LinkedIn ?

Une publication document LinkedIn est ce que la plupart des gens appellent un « carrousel LinkedIn », mais l'API de LinkedIn emploie le mot carrousel pour un autre format, que les publications organiques ne peuvent pas utiliser. La référence de la Posts API contient un tableau des types de contenu avec une colonne pour les publications organiques et une pour les publications sponsorisées, et les lignes divergent précisément sur ce point.

Type de contenu	Organique (non sponsorisé)	Sponsorisé
Documents	Oui	Oui
Carousels	Non	Oui
MultiImage	Oui	Non
Images	Oui	Oui
Videos	Oui	Oui

Lisez attentivement la ligne Carousels. Dans le vocabulaire de LinkedIn, un carrousel est une unité publicitaire sponsorisée. Une publication organique qui défile latéralement est une publication document, et une publication organique avec plusieurs photos est une publication MultiImage. Ce sont deux formats distincts, avec deux flux de téléversement distincts.

Un outil de planification qui annonce prendre en charge les « carrousels LinkedIn » organiques parle de publications document ou de publications MultiImage, car LinkedIn n'autorise pas le type Carousel en dehors de la publicité. Notre guide général sur les publications carrousel explique comment fonctionne le format à faire défiler sur les autres réseaux, où « carrousel » désigne une série d'images.

Quel fichier téléverser pour une publication document LinkedIn ?

Téléversez un PDF pour une publication document LinkedIn, car un PDF fige vos polices et votre mise en page avant que LinkedIn ne touche au fichier. LinkedIn accepte aussi PPT, PPTX, DOC et DOCX, mais il doit traiter chaque fichier téléversé avant qu'il puisse apparaître dans une publication. La Documents API décrit le statut PROCESSING ainsi : « Asset is processing to generate missing artifacts. » L'exemple de réponse de cette page renvoie une downloadUrl dont le chemin contient ads-document-pdf-analyzed, un nom de chemin qui laisse penser que LinkedIn conserve une version PDF de ce que vous avez envoyé.

Téléversez un fichier PowerPoint et toute conversion se fait du côté de LinkedIn, avec les polices dont LinkedIn dispose. Téléversez un PDF et la conversion a déjà eu lieu sur votre machine, où vous avez vu le résultat. LinkedIn ne documente pas la façon dont il affiche les polices absentes d'un DOCX ou d'un PPTX.

Des deux limites, c'est celle des 100MB que les diapositives chargées en images atteignent en premier, car un PDF exporté en qualité impression conserve chaque image en pleine résolution. Le plafond de 300 pages dépasse de loin tout ce qu'un lecteur parcourra dans un fil.

PDF ou PowerPoint et Word

PDF

• Les polices et la mise en page sont figées avant l'envoi
• Ce que vous voyez dans le fichier est ce que LinkedIn reçoit
• Correspond au nom de chemin ads-document-pdf-analyzed dans downloadUrl

PPT, PPTX, DOC, DOCX

• LinkedIn convertit le fichier de son côté
• Le rendu des polices manquantes n'est pas documenté
• Toujours limité à 100MB et 300 pages

Comment une publication document est-elle publiée via l'API LinkedIn ?

Une publication document est publiée en deux étapes : vous téléversez le fichier vers la Documents API et récupérez un URN de document, puis vous créez une publication qui référence cet URN. La page de la Documents API détaille chaque appel.

1. Appelez POST /rest/documents?action=initializeUpload avec un initializeUploadRequest qui désigne l'owner, soit un URN de personne, soit un URN d'organisation.
2. Lisez la réponse. Elle renvoie une uploadUrl, un horodatage uploadUrlExpiresAt et l'URN document sous la forme urn:li:document:{id}.
3. Téléversez le fichier vers l'uploadUrl. L'exemple de LinkedIn utilise curl --upload-file avec un jeton bearer et reçoit HTTP/2 201.
4. Appelez GET /rest/documents/{document URN} et lisez status jusqu'à ce qu'il indique AVAILABLE.
5. Appelez POST /rest/posts avec content.media.id défini sur l'URN du document et content.media.title défini sur le titre que vous voulez pour le document, plus les champs commentary, visibility, distribution et lifecycleState de la publication.

La page ajoute une restriction : « SYNCHRONOUS_UPLOAD is not supported in Documents API. » Le flux reprend celui des images, et notre explication sur la façon dont LinkedIn initializeUpload transforme un fichier en URN d'image montre le même schéma avec ses tableaux d'erreurs.

La page de LinkedIn ne précise pas si une publication peut référencer un document encore en cours de traitement. Attendre AVAILABLE à l'étape 4 est l'ordre qui ne dépend jamais de cette réponse.

Que signifient les valeurs de statut d'un document LinkedIn ?

Un asset de document LinkedIn passe par quatre valeurs de statut qui indiquent si le fichier peut déjà entrer dans une publication. La Documents API définit chacune d'elles dans son tableau de schéma.

Statut	Définition de LinkedIn
WAITING_UPLOAD	« Waiting for client to upload source file or uploading process to be completed. »
PROCESSING	« Asset is processing to generate missing artifacts. »
AVAILABLE	« All of the recipe's required artifacts are ready. The asset is available to be served. »
PROCESSING_FAILED	« Processing failed due to client error such as file size too large, unsupported file format, internal error (e.g., performance issue, database error, network failure), or other issue. »

PROCESSING_FAILED est celui à anticiper. Sa définition regroupe sous une seule valeur vos erreurs, comme un fichier de 120MB ou un format non pris en charge, et les pannes de LinkedIn lui-même. Le statut seul ne vous dit pas de quel côté vient l'échec. Vérifiez d'abord le fichier par rapport aux limites. S'il les respecte, téléversez-le à nouveau. Quand une publication document programmée ne part pas, cette distinction entre problème de fichier et problème de plateforme est la première chose à vérifier, et notre guide sur les publications LinkedIn programmées qui ne fonctionnent pas couvre les autres causes.

Qui peut publier une publication document LinkedIn ?

Un membre LinkedIn peut publier une publication document sur son propre profil, et un administrateur de page entreprise peut en publier une sur la page. La Documents API vérifie les autorisations par rapport au propriétaire désigné lors du téléversement. « For documents with company URN owners, the caller must have ADMIN or DSC permissions for the company page. » Pour les propriétaires de type personne, « the caller must match the document owner. »

Les scopes suivent la même séparation. w_member_social publie au nom du membre authentifié, et w_organization_social publie au nom d'une organisation, ce que LinkedIn réserve à « the company admin, DSC poster, or content admin. » Un appelant sans l'autorisation adéquate reçoit une erreur 403 avec le message « Accessing this document resource is forbidden. Please check your permissions for this resource. »

Choisissez le propriétaire avant de téléverser. La vérification des autorisations porte sur le propriétaire désigné dans initializeUpload, donc un fichier destiné à une publication de page entreprise doit être envoyé avec l'URN de l'organisation comme propriétaire, et non l'URN du membre qui effectue le téléversement.

Comment préparer un fichier pour une publication document LinkedIn ?

Pour préparer un fichier destiné à une publication document LinkedIn, exportez-le en PDF, vérifiez-le par rapport aux deux limites de LinkedIn et fixez le titre du document avant de programmer.

1. Exportez la présentation ou le document en PDF depuis l'application dans laquelle vous l'avez conçu.
2. Vérifiez que la taille du fichier est inférieure à 100MB. Compressez les images du PDF si ce n'est pas le cas.
3. Vérifiez que le nombre de pages est inférieur à 300.
4. Ouvrez le PDF et parcourez-le une fois. Ce que vous voyez est ce avec quoi LinkedIn va travailler.
5. Rédigez le titre du document séparément du texte de la publication. L'API le stocke dans content.media.title, à part de commentary.
6. Placez la raison d'ouvrir le document sur la première page, puisque la première page est ce qui s'affiche avant que quiconque ne le parcoure.

L'étape 6 est liée à la façon dont LinkedIn mesure l'attention. Le temps de lecture du fil LinkedIn commence à être compté quand « at least half of a feed update is visible as a member scrolls through their feed », selon l'équipe d'ingénierie de LinkedIn, et une publication document est une mise à jour du fil comme une autre. La première page est la partie du document affichée à l'écran au moment où ce chronomètre démarre.

Peut-on programmer une publication document LinkedIn avec AdaptlyPost ?

AdaptlyPost programme des publications document LinkedIn sur les profils LinkedIn et les pages entreprise connectés. Dans l'éditeur, Document est l'un des types de contenu aux côtés des publications texte, image, vidéo et carrousel, et le téléversement accepte « PDF, PPT, PPTX, DOC or DOCX, up to 100MB », ce qui correspond aux types de fichier et au plafond de taille de LinkedIn. Les options LinkedIn comprennent un champ de titre du document, décrit dans l'éditeur comme « Shown above the carousel in the LinkedIn feed ». Les textes d'AdaptlyPost n'indiquent pas de limite de pages distincte, c'est donc le plafond de 300 pages de LinkedIn qui s'applique. La page du planificateur de publications LinkedIn explique comment connecter un profil ou une page via OAuth et mettre des publications en file d'attente, et notre guide sur comment programmer des publications LinkedIn compare les options de planification.

Questions fréquentes

Quels types de fichier une publication document LinkedIn peut-elle utiliser ?

LinkedIn accepte les fichiers PPT, PPTX, DOC, DOCX et PDF pour les publications document. La Documents API liste ces cinq formats et aucun autre. Le PDF est le choix le plus sûr, car il fige les polices et la mise en page avant que LinkedIn ne traite le fichier.

Quelle taille peut atteindre un document LinkedIn ?

LinkedIn plafonne un document à 100MB et 300 pages. Les deux limites viennent de la référence de la Documents API. La définition du statut PROCESSING_FAILED cite « file size too large » parmi ses causes.

Un carrousel LinkedIn est-il la même chose qu'une publication document ?

Pour les publications organiques, le carrousel à faire défiler dont tout le monde parle est une publication document. L'API de LinkedIn réserve le type de contenu Carousel aux publicités sponsorisées et l'indique comme indisponible pour les publications organiques. Une publication organique avec plusieurs photos est une publication MultiImage distincte.

Une publication document LinkedIn peut-elle être publiée via l'API ?

Oui. Vous téléversez le fichier via l'action initializeUpload de la Documents API, qui renvoie un URN de document, puis vous créez la publication avec POST /rest/posts en définissant cet URN comme content.media.id. La Documents API ne prend pas en charge SYNCHRONOUS_UPLOAD, donc le fichier passe toujours par l'URL de téléversement avant la création de la publication.

Qu'est-ce que le titre d'une publication document LinkedIn ?

Le titre est un champ distinct, content.media.title, qui appartient au document et non au texte de la publication. L'exemple de requête de LinkedIn le définit sur « Example.pdf ». L'éditeur d'AdaptlyPost décrit son champ de titre du document comme « Shown above the carousel in the LinkedIn feed ».

Une page entreprise peut-elle publier une publication document LinkedIn ?

Oui. Une publication document de page entreprise exige que l'appelant dispose des autorisations ADMIN ou DSC sur la page, et le document doit être téléversé avec l'URN de l'organisation comme propriétaire. Un membre sans ces autorisations reçoit une erreur 403 de la Documents API.

Que faut-il vérifier avant de retéléverser un document LinkedIn en échec ?

Vérifiez le fichier par rapport aux deux limites de LinkedIn, le plafond de 100MB et celui de 300 pages, car PROCESSING_FAILED regroupe les erreurs de fichier et les propres pannes de LinkedIn sous un même statut. Si le fichier passe ce contrôle, téléversez-le à nouveau.

Quels scopes de l'API LinkedIn couvrent les publications document ?

w_member_social publie un document au nom du membre authentifié, et w_organization_social publie au nom d'une page entreprise, réservé à l'admin de la page, au DSC poster ou au content admin. Le scope nécessaire dépend de l'URN de propriétaire renseignée au téléversement.

Le dwell time s'applique-t-il aux publications document LinkedIn ?

Une publication document est une mise à jour de fil comme une autre, donc le compteur de dwell time de LinkedIn démarre dès qu'au moins la moitié est visible pendant le défilement. La première page du document est ce qui s'affiche à l'écran quand ce compteur démarre, ce qui explique pourquoi le texte conseille d'y placer la raison d'ouvrir le document.

AdaptlyPost applique-t-il la limite de 300 pages de LinkedIn pour les publications document ?

Le composer d'AdaptlyPost ne mentionne pas de limite de pages propre pour les documents, donc c'est la limite de 300 pages de LinkedIn qui s'applique. Le composer correspond bien aux types de fichier et à la limite de 100MB de LinkedIn.