Was ein LinkedIn Dokument-Post ist und wie LinkedIn die Datei verarbeitet

Was ist ein LinkedIn Dokument-Post?

Ein LinkedIn Dokument-Post ist ein Feed-Beitrag, dessen Inhalt eine hochgeladene PDF-, PowerPoint- oder Word-Datei ist, die der Feed als Folge von Seiten anzeigt, durch die der Leser innerhalb des Beitrags blättert. LinkedIns Entwicklerdokumentation behandelt ihn als eigenen Inhaltstyp. Die Referenz der Posts API sagt: „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.“ Zuerst kommt die Datei, dann der Beitrag.

Die Dateigrenzen legt LinkedIn auf der Seite zur Documents API fest: „The file size can't exceed 100MB and 300 pages. The following file types are supported: PPT, PPTX, DOC, DOCX, and PDF.“ Diese zwei Sätze sind die gesamte Spezifikation, die LinkedIn für die Datei veröffentlicht.

Eigenschaft	Wert	Quelle
Dateitypen	PPT, PPTX, DOC, DOCX, PDF	Documents API
Maximale Dateigröße	100MB	Documents API
Maximale Seitenzahl	300	Documents API
Asset-Kennung	urn:li:document:{id}	Posts API
Organische Beiträge	Unterstützt	Posts API
Gesponserte Beiträge	Unterstützt	Posts API
Seitengröße oder -verhältnis	Nicht dokumentiert	Keine der Seiten

Die letzte Zeile ist für das Design wichtig. LinkedIns Entwicklerseiten nennen für Dokumente weder Seitenmaße noch ein Seitenverhältnis. Jede Pixelgröße, die Sie für Dokumentseiten lesen, stammt aus den Tests irgendeiner Person, nicht aus LinkedIns Spezifikation.

Ist ein LinkedIn Dokument-Post dasselbe wie ein LinkedIn-Karussell?

Ein LinkedIn Dokument-Post ist das, was die meisten mit „LinkedIn-Karussell“ meinen, doch LinkedIns API verwendet das Wort Carousel für ein anderes Format, das organische Beiträge nicht nutzen können. Die Referenz der Posts API enthält eine Tabelle der Inhaltstypen mit einer Spalte für organische und einer für gesponserte Beiträge, und genau an diesem Punkt unterscheiden sich die Zeilen.

Inhaltstyp	Organisch (nicht gesponsert)	Gesponsert
Documents	Ja	Ja
Carousels	Nein	Ja
MultiImage	Ja	Nein
Images	Ja	Ja
Videos	Ja	Ja

Lesen Sie die Zeile Carousels genau. In LinkedIns Sprachgebrauch ist ein Carousel eine gesponserte Anzeigeneinheit. Ein organischer Beitrag, durch den man seitlich wischt, ist ein Dokument-Post, und ein organischer Beitrag mit mehreren Fotos ist ein MultiImage-Post. Das sind zwei getrennte Formate mit zwei getrennten Upload-Abläufen.

Ein Scheduler, der organische „LinkedIn-Karussells“ zu unterstützen behauptet, meint Dokument-Posts oder MultiImage-Posts, denn LinkedIn erlaubt den Typ Carousel außerhalb von Anzeigen nicht. Unser allgemeiner Leitfaden zu Karussell-Posts erklärt, wie das Wischformat auf den anderen Netzwerken funktioniert, wo „Karussell“ eine Reihe von Bildern bedeutet.

Welche Datei sollten Sie für einen LinkedIn Dokument-Post hochladen?

Laden Sie für einen LinkedIn Dokument-Post eine PDF hoch, denn eine PDF legt Schriften und Layout fest, bevor LinkedIn die Datei anfasst. LinkedIn akzeptiert auch PPT, PPTX, DOC und DOCX, muss aber jeden Upload verarbeiten, bevor die Datei in einem Beitrag erscheinen kann. Die Documents API beschreibt den Status PROCESSING als „Asset is processing to generate missing artifacts.“ Die Beispielantwort auf dieser Seite liefert eine downloadUrl, deren Pfad ads-document-pdf-analyzed enthält, ein Pfadname, der nahelegt, dass LinkedIn von allem, was Sie schicken, eine PDF-Version ablegt.

Laden Sie eine PowerPoint-Datei hoch, passiert jede Konvertierung auf LinkedIns Seite, mit den Schriften, die LinkedIn gerade hat. Laden Sie eine PDF hoch, ist sie schon auf Ihrem Rechner passiert, wo Sie das Ergebnis gesehen haben. LinkedIn dokumentiert nicht, wie es Schriften darstellt, die in einer DOCX oder PPTX fehlen.

Von den beiden Grenzen erreichen bildlastige Folien zuerst die 100MB, denn eine in Druckqualität exportierte PDF behält jedes Bild in voller Auflösung. Die Obergrenze von 300 Seiten liegt weit über allem, was ein Leser im Feed durchblättert.

PDF oder PowerPoint und Word

PDF

• Schriftarten und Layout stehen schon vor dem Hochladen fest
• Was Sie in der Datei sehen, ist das, womit LinkedIn arbeitet
• Passt zum Pfadnamen ads-document-pdf-analyzed in der downloadUrl

PPT, PPTX, DOC, DOCX

• LinkedIn konvertiert die Datei auf eigener Seite
• Wie fehlende Schriftarten gerendert werden, ist nicht dokumentiert
• Trotzdem auf 100MB und 300 Seiten begrenzt

Wie wird ein Dokument-Post über die LinkedIn API veröffentlicht?

Ein Dokument-Post wird in zwei Stufen veröffentlicht: Sie laden die Datei in die Documents API hoch und bekommen eine Dokument-URN zurück, dann erstellen Sie einen Beitrag, der auf diese URN verweist. Die Seite zur Documents API geht jeden Aufruf durch.

1. Rufen Sie POST /rest/documents?action=initializeUpload mit einem initializeUploadRequest auf, der den owner nennt, entweder eine Personen-URN oder eine Organisations-URN.
2. Lesen Sie die Antwort. Sie liefert eine uploadUrl, einen Zeitstempel uploadUrlExpiresAt und die document-URN in der Form urn:li:document:{id}.
3. Laden Sie die Datei zur uploadUrl hoch. LinkedIns Beispiel nutzt curl --upload-file mit einem Bearer-Token und erhält HTTP/2 201 zurück.
4. Rufen Sie GET /rest/documents/{document URN} auf und lesen Sie status, bis dort AVAILABLE steht.
5. Rufen Sie POST /rest/posts auf, mit content.media.id gleich der Dokument-URN und content.media.title gleich dem Titel, den Sie auf dem Dokument wollen, dazu commentary, visibility, distribution und lifecycleState des Beitrags.

Die Seite fügt eine Einschränkung hinzu: „SYNCHRONOUS_UPLOAD is not supported in Documents API.“ Der Ablauf entspricht dem für Bilder, und unsere Anleitung dazu, wie LinkedIn initializeUpload aus einer Datei eine Bild-URN macht, zeigt dasselbe Muster samt Fehlertabellen.

LinkedIns Seite sagt nicht, ob ein Beitrag auf ein Dokument verweisen kann, das noch verarbeitet wird. Auf AVAILABLE in Schritt 4 zu warten ist die Reihenfolge, die nie von dieser Antwort abhängt.

Was bedeuten die Statuswerte von LinkedIn-Dokumenten?

Ein LinkedIn-Dokument-Asset durchläuft vier Statuswerte, die Ihnen sagen, ob die Datei schon in einen Beitrag darf. Die Documents API definiert jeden davon in ihrer Schematabelle.

Status	LinkedIns Definition
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.“

Mit PROCESSING_FAILED sollten Sie planen. Seine Definition wirft Ihre Fehler, etwa eine 120MB-Datei oder ein nicht unterstütztes Format, mit LinkedIns eigenen Ausfällen in einen Wert zusammen. Der Status allein verrät nicht, welche Seite gescheitert ist. Prüfen Sie zuerst die Datei gegen die Grenzen. Liegt sie innerhalb davon, laden Sie sie erneut hoch. Wenn ein geplanter Dokument-Post nicht rausgeht, ist diese Trennung zwischen Dateiproblemen und Plattformproblemen das Erste, was Sie prüfen sollten, und unser Leitfaden zu geplanten LinkedIn-Posts, die nicht funktionieren, behandelt die übrigen Ursachen.

Wer kann einen LinkedIn Dokument-Post veröffentlichen?

Ein LinkedIn-Mitglied kann einen Dokument-Post auf dem eigenen Profil veröffentlichen, und ein Admin einer Unternehmensseite kann einen auf der Seite veröffentlichen. Die Documents API prüft die Berechtigungen gegen den Owner, den Sie beim Upload angegeben haben. „For documents with company URN owners, the caller must have ADMIN or DSC permissions for the company page.“ Für Personen als Owner gilt: „the caller must match the document owner.“

Die Scopes folgen derselben Aufteilung. w_member_social veröffentlicht im Namen des authentifizierten Mitglieds, und w_organization_social veröffentlicht im Namen einer Organisation, was LinkedIn auf „the company admin, DSC poster, or content admin“ beschränkt. Wer ohne die passende Berechtigung aufruft, bekommt einen 403 mit der Meldung „Accessing this document resource is forbidden. Please check your permissions for this resource.“

Legen Sie den Owner vor dem Upload fest. Die Berechtigungsprüfung läuft gegen den Owner, der in initializeUpload genannt ist, also geht eine Datei für einen Beitrag auf einer Unternehmensseite mit der Organisations-URN als Owner hoch, nicht mit der URN des Mitglieds, das den Upload ausführt.

Wie bereiten Sie eine Datei für einen LinkedIn Dokument-Post vor?

Bereiten Sie eine Datei für einen LinkedIn Dokument-Post vor, indem Sie sie als PDF exportieren, sie gegen LinkedIns zwei Grenzen prüfen und den Dokumenttitel festlegen, bevor Sie planen.

1. Exportieren Sie die Präsentation oder das Dokument als PDF aus der App, in der Sie es gestaltet haben.
2. Prüfen Sie, dass die Datei unter 100MB liegt. Wenn nicht, komprimieren Sie die Bilder in der PDF.
3. Prüfen Sie, dass die Seitenzahl unter 300 liegt.
4. Öffnen Sie die PDF und blättern Sie sie einmal durch. Was Sie sehen, ist das, womit LinkedIn arbeitet.
5. Schreiben Sie den Dokumenttitel getrennt vom Beitragstext. Die API speichert ihn in content.media.title, getrennt von commentary.
6. Setzen Sie den Grund, das Dokument zu öffnen, auf die erste Seite, denn die erste Seite ist das, was angezeigt wird, bevor jemand weiterblättert.

Schritt 6 hängt damit zusammen, wie LinkedIn Aufmerksamkeit misst. Die Dwell Time in LinkedIns Feed beginnt zu zählen, wenn „at least half of a feed update is visible as a member scrolls through their feed“, so LinkedIns Engineering-Team, und ein Dokument-Post ist ein Feed-Update wie jedes andere. Die erste Seite ist der Teil des Dokuments, der auf dem Bildschirm steht, wenn diese Uhr anläuft.

Können Sie einen LinkedIn Dokument-Post mit AdaptlyPost planen?

AdaptlyPost plant LinkedIn-Dokument-Posts für verbundene LinkedIn-Profile und Unternehmensseiten. Im Composer ist Document einer der Inhaltstypen neben Text-, Bild-, Video- und Karussell-Posts, und der Upload akzeptiert „PDF, PPT, PPTX, DOC or DOCX, up to 100MB“, was LinkedIns eigenen Dateitypen und seiner Größengrenze entspricht. Zu den LinkedIn-Optionen gehört ein Feld für den Dokumenttitel, das der Composer mit „Shown above the carousel in the LinkedIn feed“ beschreibt. Die Texte von AdaptlyPost nennen kein eigenes Seitenlimit, also gilt LinkedIns Obergrenze von 300 Seiten. Die Seite zum LinkedIn Post Scheduler erklärt, wie Sie ein Profil oder eine Seite per OAuth verbinden und Beiträge einreihen, und unser Leitfaden dazu, wie Sie LinkedIn-Posts planen, vergleicht die Planungsoptionen.

Häufig gestellte Fragen

Welche Dateitypen kann ein LinkedIn Dokument-Post verwenden?

LinkedIn akzeptiert PPT-, PPTX-, DOC-, DOCX- und PDF-Dateien für Dokument-Posts. Die Documents API nennt diese fünf Formate und keine anderen. PDF ist die sicherste Wahl, weil sie Schriften und Layout festlegt, bevor LinkedIn die Datei verarbeitet.

Wie groß darf ein LinkedIn-Dokument sein?

LinkedIn begrenzt ein Dokument auf 100MB und 300 Seiten. Beide Grenzen stammen aus der Referenz der Documents API. Die Definition des Status PROCESSING_FAILED nennt „file size too large“ als eine seiner Ursachen.

Ist ein LinkedIn-Karussell dasselbe wie ein Dokument-Post?

Bei organischen Beiträgen ist das wischbare Karussell, von dem alle reden, ein Dokument-Post. LinkedIns API reserviert den Inhaltstyp Carousel für gesponserte Anzeigen und markiert ihn als nicht verfügbar für organische Beiträge. Ein organischer Beitrag mit mehreren Fotos ist ein eigener MultiImage-Post.

Kann ein LinkedIn Dokument-Post über die API veröffentlicht werden?

Ja. Sie laden die Datei über die Aktion initializeUpload der Documents API hoch, die eine Dokument-URN zurückgibt, erstellen dann den Beitrag mit POST /rest/posts und setzen diese URN als content.media.id. Die Documents API unterstützt kein SYNCHRONOUS_UPLOAD, also geht die Datei immer über die Upload-URL hoch, bevor der Beitrag erstellt wird.

Was ist der Titel bei einem LinkedIn Dokument-Post?

Der Titel ist ein eigenes Feld, content.media.title, das zum Dokument gehört und nicht zum Beitragstext. LinkedIns Beispielanfrage setzt ihn auf „Example.pdf“. Der Composer von AdaptlyPost beschreibt sein Feld für den Dokumenttitel mit „Shown above the carousel in the LinkedIn feed“.

Kann eine Unternehmensseite einen LinkedIn Dokument-Post veröffentlichen?

Ja. Ein Dokument-Post auf einer Unternehmensseite verlangt, dass der Aufrufer ADMIN- oder DSC-Berechtigungen für die Seite hat, und das Dokument muss mit der Organisations-URN als Owner hochgeladen werden. Ein Mitglied ohne diese Berechtigungen bekommt von der Documents API einen 403.

Was sollten Sie vor dem erneuten Hochladen eines fehlgeschlagenen LinkedIn-Dokuments prüfen?

Prüfen Sie die Datei gegen LinkedIns zwei Grenzwerte, die 100MB-Obergrenze und die 300-Seiten-Grenze, denn PROCESSING_FAILED fasst Dateifehler und LinkedIns eigene Störungen unter einem einzigen Status zusammen. Besteht die Datei diese Prüfung, laden Sie sie einfach erneut hoch.

Welche LinkedIn-API-Scopes gelten für Dokument-Posts?

w_member_social veröffentlicht ein Dokument im Namen des authentifizierten Mitglieds, und w_organization_social veröffentlicht im Namen einer Unternehmensseite, beschränkt auf den Seitenadmin, DSC-Poster oder Content-Admin. Welcher Scope nötig ist, hängt davon ab, welche Owner-URN Sie beim Upload angeben.

Gilt Dwell Time auch für LinkedIn Dokument-Posts?

Ein Dokument-Post ist ein Feed-Update wie jedes andere, also startet LinkedIns Dwell-Time-Zähler, sobald mindestens die Hälfte davon beim Scrollen sichtbar ist. Die erste Seite des Dokuments ist das, was auf dem Bildschirm steht, wenn dieser Zähler startet, weshalb der Text rät, den Grund zum Öffnen genau dort zu platzieren.

Setzt AdaptlyPost LinkedIns 300-Seiten-Grenze für Dokument-Posts durch?

AdaptlyPosts Composer nennt kein eigenes Seitenlimit für Dokument-Uploads, also gilt LinkedIns eigene 300-Seiten-Grenze. Der Composer stimmt bei Dateitypen und der 100MB-Grenze mit LinkedIns Angaben überein.