Słownik

Czym jest post z dokumentem na LinkedInie i jak LinkedIn przetwarza plik

Taras Shynkarenko
Taras Shynkarenko
•Zaktualizowano: •8 min czytania
Czym jest post z dokumentem na LinkedInie i jak LinkedIn przetwarza plikCzym jest post z dokumentem na LinkedInie i jak LinkedIn przetwarza plik

TL;DR, szybka odpowiedź

8 min czytania

Post z dokumentem na LinkedInie to post w feedzie, którego treścią jest przesłany plik PDF, PPT, PPTX, DOC lub DOCX o rozmiarze do 100 MB i do 300 stron. Przewijana „karuzela na LinkedInie", o której wszyscy mówią, to właśnie ten format. Typ treści Carousel w API LinkedIna to format wyłącznie reklamowy, niedostępny dla postów organicznych. Przez API najpierw wysyłasz plik, LinkedIn przetwarza go na URN dokumentu, a post odwołuje się do tego URN i podaje tytuł.

Czym jest post z dokumentem na LinkedInie?

Post z dokumentem na LinkedInie to post w feedzie, którego treścią jest przesłany plik PDF, PowerPoint lub Word. Feed wyświetla go jako zestaw stron, które czytelnik przegląda wewnątrz posta. Dokumentacja LinkedIna dla programistów traktuje go jako osobny typ treści. Dokumentacja Posts API stwierdza: "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." Najpierw plik, potem post.

LinkedIn podaje limity pliku na stronie Documents API: "The file size can't exceed 100MB and 300 pages. The following file types are supported: PPT, PPTX, DOC, DOCX, and PDF." Te dwa zdania to cała specyfikacja pliku, jaką LinkedIn publikuje.

WłaściwośćWartośćŹródło
Typy plikówPPT, PPTX, DOC, DOCX, PDFDocuments API
Maksymalny rozmiar pliku100 MBDocuments API
Maksymalna liczba stron300Documents API
Identyfikator zasobuurn:li:document:{id}Posts API
Publikacja organicznaObsługiwanaPosts API
Publikacja sponsorowanaObsługiwanaPosts API
Rozmiar lub proporcje stronyNieudokumentowaneŻadna ze stron

Ostatni wiersz ma znaczenie przy projektowaniu. Strony LinkedIna dla programistów nie podają ani wymiarów stron, ani proporcji dokumentów. Każdy rozmiar w pikselach, na jaki trafisz, pochodzi z czyichś testów, a nie ze specyfikacji LinkedIna.

Czy post z dokumentem na LinkedInie to to samo co karuzela?

Post z dokumentem to właśnie to, co większość ludzi nazywa „karuzelą na LinkedInie", ale API LinkedIna używa słowa carousel na określenie innego formatu, niedostępnego dla postów organicznych. Dokumentacja Posts API zawiera tabelę typów treści z osobnymi kolumnami dla postów organicznych i sponsorowanych, a wiersze różnią się dokładnie w tym punkcie.

Typ treściOrganiczne (niesponsorowane)Sponsorowane
DocumentsTakTak
CarouselsNieTak
MultiImageTakNie
ImagesTakTak
VideosTakTak

Przyjrzyj się wierszowi Carousels. W słowniku LinkedIna karuzela to jednostka reklamy sponsorowanej. Post organiczny przewijany na boki to post z dokumentem, a post organiczny z kilkoma zdjęciami to post MultiImage. To dwa odrębne formaty z dwoma odrębnymi procesami przesyłania.

Narzędzie do planowania, które deklaruje obsługę organicznych „karuzel na LinkedInie", ma na myśli posty z dokumentem albo posty MultiImage, bo LinkedIn nie dopuszcza typu Carousel poza reklamami. Nasz ogólny przewodnik po postach karuzelowych wyjaśnia, jak format przewijany działa w innych serwisach, gdzie „karuzela" oznacza zestaw obrazów.

Osoba eksportuje plik do PDF na laptopie, zanim prześle go jako post z dokumentem.

Jaki plik przesłać w poście z dokumentem na LinkedInie?

Prześlij plik PDF, bo PDF utrwala czcionki i układ, zanim LinkedIn w ogóle dotknie pliku. LinkedIn przyjmuje też PPT, PPTX, DOC i DOCX, ale każdy przesłany plik musi przetworzyć, zanim będzie mógł się pojawić w poście. Documents API opisuje status PROCESSING słowami "Asset is processing to generate missing artifacts." Przykładowa odpowiedź na tej stronie zwraca downloadUrl ze ścieżką zawierającą ads-document-pdf-analyzed. Taka nazwa sugeruje, że LinkedIn przechowuje wersję PDF tego, co wysyłasz.

Gdy prześlesz plik PowerPoint, ewentualna konwersja odbywa się po stronie LinkedIna, z czcionkami, które LinkedIn akurat ma. Gdy prześlesz PDF, konwersja jest już za tobą i widzisz jej efekt na swoim komputerze. LinkedIn nie opisuje, jak renderuje czcionki, których brakuje w pliku DOCX lub PPTX.

Z tych dwóch limitów slajdy pełne grafik najszybciej dobijają do 100 MB, bo PDF wyeksportowany w jakości do druku zachowuje każdy obraz w pełnej rozdzielczości. Limit 300 stron jest daleko poza tym, co ktokolwiek przejrzy w feedzie.

PDF czy PowerPoint i Word
PDF
  • Czcionki i układ są utrwalone przed przesłaniem
  • To, co widzisz w pliku, trafia do LinkedIna
  • Pasuje do nazwy ścieżki downloadUrl ads-document-pdf-analyzed
PPT, PPTX, DOC, DOCX
  • LinkedIn konwertuje plik po swojej stronie
  • Renderowanie brakujących czcionek nie jest udokumentowane
  • Nadal obowiązuje limit 100 MB i 300 stron
Documents API przyjmuje wszystkie pięć formatów, ale tylko jeden z nich omija konwersję po stronie LinkedIna.

Jak opublikować post z dokumentem przez API LinkedIna?

Post z dokumentem publikuje się w dwóch etapach: przesyłasz plik do Documents API i otrzymujesz URN dokumentu, a potem tworzysz post, który się do niego odwołuje. Strona Documents API opisuje każde wywołanie.

  1. Wywołaj POST /rest/documents?action=initializeUpload z initializeUploadRequest, w którym wskazujesz owner, czyli URN osoby albo URN organizacji.
  2. Odczytaj odpowiedź. Zawiera uploadUrl, znacznik czasu uploadUrlExpiresAt i URN document w postaci urn:li:document:{id}.
  3. Prześlij plik pod uploadUrl. Przykład LinkedIna używa curl --upload-file z tokenem bearer i otrzymuje HTTP/2 201.
  4. Wywołuj GET /rest/documents/{document URN} i sprawdzaj status, aż pojawi się AVAILABLE.
  5. Wywołaj POST /rest/posts, ustawiając content.media.id na URN dokumentu, a content.media.title na tytuł dokumentu, i dodaj commentary, visibility, distribution oraz lifecycleState posta.

Strona dodaje jedno ograniczenie: "SYNCHRONOUS_UPLOAD is not supported in Documents API." Proces przypomina ten dla obrazów, a nasz opis tego, jak initializeUpload na LinkedInie zamienia plik w URN obrazu, pokazuje ten sam schemat wraz z tabelami błędów.

Strona LinkedIna nie mówi, czy post może odwoływać się do dokumentu, który wciąż jest przetwarzany. Oczekiwanie na AVAILABLE w kroku 4 sprawia, że odpowiedź na to pytanie przestaje mieć znaczenie.

Co oznaczają statusy dokumentu na LinkedInie?

Zasób dokumentu na LinkedInie przechodzi przez cztery statusy, które mówią, czy plik może już trafić do posta. Documents API definiuje każdy z nich w tabeli schematu.

StatusDefinicja LinkedIna
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."

Na PROCESSING_FAILED trzeba się przygotować. Jego definicja wrzuca do jednego worka twoje błędy, takie jak plik 120 MB czy nieobsługiwany format, oraz awarie po stronie LinkedIna. Sam status nie powie ci, która strona zawiodła. Najpierw sprawdź plik pod kątem limitów. Jeśli się w nich mieści, prześlij go ponownie. Gdy zaplanowany post z dokumentem się nie ukaże, ten podział na problemy z plikiem i problemy z platformą warto sprawdzić w pierwszej kolejności, a pozostałe przyczyny opisuje nasz przewodnik o tym, dlaczego zaplanowane posty na LinkedInie nie działają.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Menedżerka przegląda dokument na tablecie, tak jak administrator strony firmowej przed publikacją.

Kto może opublikować post z dokumentem na LinkedInie?

Członek LinkedIna może opublikować post z dokumentem na własnym profilu, a administrator strony firmowej na tej stronie. Documents API sprawdza uprawnienia względem właściciela wskazanego przy przesyłaniu. "For documents with company URN owners, the caller must have ADMIN or DSC permissions for the company page." W przypadku właścicieli będących osobami: "the caller must match the document owner."

Zakresy dzielą się tak samo. w_member_social publikuje w imieniu uwierzytelnionego członka, a w_organization_social w imieniu organizacji, co LinkedIn ogranicza do "the company admin, DSC poster, or content admin." Wywołujący bez odpowiednich uprawnień dostaje błąd 403 z komunikatem "Accessing this document resource is forbidden. Please check your permissions for this resource."

Ustal właściciela przed przesłaniem pliku. Uprawnienia są sprawdzane względem właściciela wskazanego w initializeUpload, więc plik przeznaczony na stronę firmową przesyłasz z URN organizacji jako właścicielem, a nie z URN osoby, która go wysyła.

Jak przygotować plik do posta z dokumentem na LinkedInie?

Wyeksportuj plik do PDF, sprawdź go pod kątem dwóch limitów LinkedIna i ustal tytuł dokumentu, zanim zaplanujesz publikację.

  1. Wyeksportuj prezentację lub dokument do PDF z aplikacji, w której powstał.
  2. Sprawdź, czy plik ma mniej niż 100 MB. Jeśli nie, skompresuj obrazy w PDF.
  3. Sprawdź, czy liczba stron nie przekracza 300.
  4. Otwórz PDF i przejrzyj go raz strona po stronie. To, co widzisz, trafi do LinkedIna.
  5. Napisz tytuł dokumentu osobno od tekstu posta. API przechowuje go w content.media.title, oddzielnie od commentary.
  6. Na pierwszej stronie umieść powód, by otworzyć dokument, bo to ją widać, zanim ktokolwiek zacznie przewijać.

Krok 6 wiąże się ze sposobem, w jaki LinkedIn mierzy uwagę. Czas przebywania w feedzie LinkedIna zaczyna się liczyć, gdy "at least half of a feed update is visible as a member scrolls through their feed", jak podaje zespół inżynierów LinkedIna, a post z dokumentem jest aktualizacją w feedzie jak każda inna. Pierwsza strona to ta część dokumentu, która jest na ekranie w chwili, gdy zegar rusza.

Czy można zaplanować post z dokumentem na LinkedInie w AdaptlyPost?

AdaptlyPost planuje posty z dokumentem na połączonych profilach i stronach firmowych na LinkedInie. W edytorze Document jest jednym z typów treści obok postów tekstowych, ze zdjęciem, wideo i karuzel, a przesyłanie przyjmuje "PDF, PPT, PPTX, DOC or DOCX, up to 100MB", co odpowiada typom plików i limitowi rozmiaru LinkedIna. Opcje LinkedIna obejmują pole tytułu dokumentu, opisane w edytorze jako "Shown above the carousel in the LinkedIn feed". AdaptlyPost nie podaje osobnego limitu stron, więc obowiązuje limit 300 stron LinkedIna. Strona narzędzia do planowania postów na LinkedInie opisuje łączenie profilu lub strony przez OAuth i kolejkowanie postów, a nasz przewodnik o tym, jak planować posty na LinkedInie, porównuje dostępne opcje.

Najczęściej zadawane pytania

Jakich typów plików można użyć w poście z dokumentem na LinkedInie?

LinkedIn przyjmuje w postach z dokumentem pliki PPT, PPTX, DOC, DOCX i PDF. Documents API wymienia te pięć formatów i żadnych innych. Najbezpieczniejszy jest PDF, bo utrwala czcionki i układ, zanim LinkedIn przetworzy plik.

Jak duży może być dokument na LinkedInie?

LinkedIn ogranicza dokument do 100 MB i 300 stron. Oba limity pochodzą z dokumentacji Documents API. Definicja statusu PROCESSING_FAILED wymienia "file size too large" jako jedną z przyczyn.

Czy karuzela na LinkedInie to to samo co post z dokumentem?

W przypadku postów organicznych przewijana karuzela, o której wszyscy mówią, jest postem z dokumentem. API LinkedIna rezerwuje typ treści Carousel dla reklam sponsorowanych i oznacza go jako niedostępny dla postów organicznych. Post organiczny z kilkoma zdjęciami to osobny post MultiImage.

Czy post z dokumentem można opublikować przez API LinkedIna?

Tak. Przesyłasz plik przez akcję initializeUpload w Documents API, która zwraca URN dokumentu, a potem tworzysz post przez POST /rest/posts, ustawiając ten URN jako content.media.id. Documents API nie obsługuje SYNCHRONOUS_UPLOAD, więc plik zawsze trafia na adres przesyłania, zanim powstanie post.

Czym jest tytuł posta z dokumentem na LinkedInie?

Tytuł to osobne pole, content.media.title, które należy do dokumentu, a nie do tekstu posta. Przykładowe żądanie LinkedIna ustawia w nim "Example.pdf". Edytor AdaptlyPost opisuje pole tytułu dokumentu jako "Shown above the carousel in the LinkedIn feed".

Czy strona firmowa może opublikować post z dokumentem na LinkedInie?

Tak. Post z dokumentem na stronie firmowej wymaga, by wywołujący miał na niej uprawnienia ADMIN lub DSC, a dokument musi zostać przesłany z URN organizacji jako właścicielem. Członek bez tych uprawnień otrzyma z Documents API błąd 403.

Co sprawdzić przed ponownym przesłaniem dokumentu, którego przetwarzanie się nie udało?

Sprawdź plik pod kątem dwóch limitów LinkedIna, czyli 100 MB i 300 stron, bo PROCESSING_FAILED łączy błędy w pliku i błędy samego LinkedIna w jednym statusie. Jeśli plik je spełnia, prześlij go ponownie.

Jakie zakresy API LinkedIna obejmują posty z dokumentem?

w_member_social publikuje dokument w imieniu uwierzytelnionego członka, a w_organization_social w imieniu strony firmowej, z ograniczeniem do administratora firmy, publikującego DSC lub administratora treści. Potrzebny zakres zależy od URN właściciela ustawionego przy przesyłaniu.

AdaptlyPost
AdaptlyPost

Rozpocznij 7-dniowy bezpłatny okres próbny

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Czy czas przebywania dotyczy postów z dokumentem na LinkedInie?

Post z dokumentem jest aktualizacją w feedzie jak każda inna, więc zegar czasu przebywania LinkedIna rusza, gdy co najmniej połowa posta jest widoczna podczas przewijania. Na ekranie jest wtedy pierwsza strona dokumentu i dlatego właśnie tam warto umieścić powód, by go otworzyć.

Czy AdaptlyPost pilnuje limitu 300 stron LinkedIna w postach z dokumentem?

Edytor AdaptlyPost nie podaje osobnego limitu stron dla przesyłanych dokumentów, więc obowiązuje limit 300 stron LinkedIna. Edytor jest za to zgodny z typami plików LinkedIna i limitem rozmiaru 100 MB.

Czy ten artykuł był pomocny?

Chętnie poznamy opinię!

Więcej naszych treści w Google

Jedno kliknięcie oznacza AdaptlyPost jako preferowane źródło, dzięki czemu nasze artykuły pojawiają się wyżej w Najważniejszych wiadomościach, trybie AI i Podsumowaniach AI.

Jeszcze chwila...

AdaptlyPost

AdaptlyPost

Planowanie treści na wszystkich platformach

Wszystkie konta społecznościowe w jednym miejscu dzięki AdaptlyPost.

Analityka wszystkich platform

Skrzynka społecznościowa

Asystent oparty na AI

Powiązane hasła ze słownika

Powiązane artykuły