O que é um post de documento no LinkedIn e como o LinkedIn processa o arquivo

O que é um post de documento no LinkedIn?

Um post de documento no LinkedIn é um post do feed cujo conteúdo é um arquivo PDF, PowerPoint ou Word enviado, que o feed mostra como um conjunto de páginas que o leitor percorre dentro do próprio post. A documentação para desenvolvedores do LinkedIn trata esse formato como um tipo de conteúdo próprio. A referência da Posts API diz: "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." Primeiro vem o arquivo, depois o post.

O LinkedIn define os limites do arquivo na página da Documents API: "The file size can't exceed 100MB and 300 pages. The following file types are supported: PPT, PPTX, DOC, DOCX, and PDF." Essas duas frases são toda a especificação que o LinkedIn publica para o arquivo.

Propriedade	Valor	Fonte
Tipos de arquivo	PPT, PPTX, DOC, DOCX, PDF	Documents API
Tamanho máximo do arquivo	100MB	Documents API
Máximo de páginas	300	Documents API
Identificador do recurso	urn:li:document:{id}	Posts API
Publicação orgânica	Aceita	Posts API
Publicação patrocinada	Aceita	Posts API
Tamanho ou proporção da página	Não documentado	Nenhuma das páginas

A última linha importa para o design. As páginas para desenvolvedores do LinkedIn não dão dimensões de página nem proporção para documentos. Qualquer tamanho em pixels que você leia para páginas de documento vem de testes de alguém, não da especificação do LinkedIn.

Um post de documento no LinkedIn é a mesma coisa que um carrossel do LinkedIn?

Um post de documento no LinkedIn é o que a maioria das pessoas chama de "carrossel do LinkedIn", mas a API do LinkedIn usa a palavra carousel para outro formato, que posts orgânicos não podem usar. A referência da Posts API tem uma tabela de tipos de conteúdo com uma coluna para posts orgânicos e outra para posts patrocinados, e as linhas divergem justamente nesse ponto.

Tipo de conteúdo	Orgânico (não patrocinado)	Patrocinado
Documents	Sim	Sim
Carousels	Não	Sim
MultiImage	Sim	Não
Images	Sim	Sim
Videos	Sim	Sim

Leia a linha Carousels com atenção. No vocabulário do LinkedIn, carousel é uma unidade de anúncio patrocinado. Um post orgânico que desliza para o lado é um post de documento, e um post orgânico com várias fotos é um post MultiImage. São dois formatos separados, com dois fluxos de envio separados.

Uma ferramenta de agendamento que diz aceitar "carrosséis do LinkedIn" orgânicos está falando de posts de documento ou de posts MultiImage, porque o LinkedIn não permite o tipo Carousel fora dos anúncios. Nosso guia geral sobre posts em carrossel mostra como o formato deslizável funciona nas outras redes, onde "carrossel" quer dizer um conjunto de imagens.

Qual arquivo você deve enviar em um post de documento no LinkedIn?

Envie um PDF em um post de documento no LinkedIn, porque o PDF fixa as fontes e o layout antes de o LinkedIn mexer no arquivo. O LinkedIn também aceita PPT, PPTX, DOC e DOCX, mas precisa processar cada envio antes de o arquivo aparecer em um post. A Documents API descreve o status PROCESSING como "Asset is processing to generate missing artifacts." A resposta de exemplo nessa página retorna uma downloadUrl cujo caminho contém ads-document-pdf-analyzed, um nome de caminho que sugere que o LinkedIn guarda uma versão em PDF de qualquer coisa que você enviou.

Envie um arquivo do PowerPoint e qualquer conversão acontece do lado do LinkedIn, com as fontes que o LinkedIn tiver. Envie um PDF e ela já aconteceu no seu computador, onde você viu o resultado. O LinkedIn não documenta como renderiza fontes que faltam em um DOCX ou PPTX.

Dos dois limites, 100MB é o que slides cheios de imagens atingem primeiro, porque um PDF exportado em qualidade de impressão mantém cada imagem em resolução máxima. O limite de 300 páginas fica muito acima de qualquer coisa que um leitor vá folhear em um feed.

PDF ou PowerPoint e Word

PDF

• As fontes e o layout já ficam fixos antes do envio
• O que você vê no arquivo é o que o LinkedIn recebe
• Combina com o nome do caminho ads-document-pdf-analyzed no downloadUrl

PPT, PPTX, DOC, DOCX

• O LinkedIn converte o arquivo do próprio lado
• Não há documentação sobre como as fontes ausentes são renderizadas
• Continua limitado a 100MB e 300 páginas

Como um post de documento é publicado pela API do LinkedIn?

Um post de documento é publicado em duas etapas: você envia o arquivo para a Documents API e recebe uma URN de documento, depois cria um post que referencia essa URN. A página da Documents API explica cada chamada.

1. Chame POST /rest/documents?action=initializeUpload com um initializeUploadRequest que indique o owner, seja uma URN de pessoa ou uma URN de organização.
2. Leia a resposta. Ela retorna uma uploadUrl, um timestamp uploadUrlExpiresAt e a URN document no formato urn:li:document:{id}.
3. Envie o arquivo para a uploadUrl. O exemplo do LinkedIn usa curl --upload-file com um bearer token e recebe HTTP/2 201.
4. Chame GET /rest/documents/{document URN} e leia o status até ele dizer AVAILABLE.
5. Chame POST /rest/posts com content.media.id definido como a URN do documento e content.media.title definido como o título que você quer no documento, além de commentary, visibility, distribution e lifecycleState do post.

A página acrescenta uma restrição: "SYNCHRONOUS_UPLOAD is not supported in Documents API." O fluxo espelha o das imagens, e nosso passo a passo de como o initializeUpload do LinkedIn transforma um arquivo em uma URN de imagem mostra o mesmo padrão com as tabelas de erro.

A página do LinkedIn não diz se um post pode referenciar um documento que ainda está em processamento. Esperar pelo AVAILABLE na etapa 4 é a ordem que nunca depende dessa resposta.

O que significam os valores de status de documento do LinkedIn?

Um recurso de documento do LinkedIn passa por quatro valores de status que dizem se o arquivo já pode entrar em um post. A Documents API define cada um na tabela do schema.

Status	Definição do 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 é o status para o qual vale se planejar. A definição junta os seus erros, como um arquivo de 120MB ou um formato não aceito, com as falhas do próprio LinkedIn em um único valor. O status sozinho não diz de que lado veio a falha. Confira o arquivo contra os limites primeiro. Se ele estiver dentro deles, envie de novo. Quando um post de documento agendado não sai, essa divisão entre problema no arquivo e problema na plataforma é a primeira coisa a verificar, e nosso guia sobre posts agendados do LinkedIn que não funcionam cobre as outras causas.

Quem pode publicar um post de documento no LinkedIn?

Um membro do LinkedIn pode publicar um post de documento no próprio perfil, e um administrador de página de empresa pode publicar um na página. A Documents API verifica as permissões contra o owner que você indicou no envio. "For documents with company URN owners, the caller must have ADMIN or DSC permissions for the company page." Para owners que são pessoas, "the caller must match the document owner."

Os escopos seguem a mesma divisão. w_member_social publica em nome do membro autenticado, e w_organization_social publica em nome de uma organização, o que o LinkedIn restringe a "the company admin, DSC poster, or content admin." Quem chama sem a permissão certa recebe um 403 com a mensagem "Accessing this document resource is forbidden. Please check your permissions for this resource."

Decida o owner antes de enviar. A verificação de permissão roda contra o owner indicado no initializeUpload, então um arquivo destinado a um post de página de empresa sobe com a URN da organização como owner, não com a URN do membro que faz o envio.

Como preparar um arquivo para um post de documento no LinkedIn?

Prepare um arquivo para um post de documento no LinkedIn exportando-o para PDF, conferindo-o contra os dois limites do LinkedIn e definindo o título do documento antes de agendar.

1. Exporte a apresentação ou o documento para PDF no app em que você o criou.
2. Confira se o arquivo tem menos de 100MB. Se não tiver, comprima as imagens dentro do PDF.
3. Confira se o número de páginas é menor que 300.
4. Abra o PDF e folheie uma vez. O que você vê é o que o LinkedIn vai receber para trabalhar.
5. Escreva o título do documento separado do texto do post. A API o guarda em content.media.title, à parte do commentary.
6. Coloque o motivo para abrir o documento na primeira página, já que a primeira página é o que aparece antes de alguém começar a folhear.

A etapa 6 se liga a como o LinkedIn mede atenção. O tempo de permanência no feed do LinkedIn começa a contar quando "at least half of a feed update is visible as a member scrolls through their feed," segundo a equipe de engenharia do LinkedIn, e um post de documento é uma atualização do feed como qualquer outra. A primeira página é a parte do documento que está na tela quando esse relógio começa.

Dá para agendar um post de documento no LinkedIn com o AdaptlyPost?

O AdaptlyPost agenda posts de documento no LinkedIn para perfis e páginas de empresa do LinkedIn conectados. No editor, Document é um dos tipos de conteúdo, ao lado de posts de texto, imagem, vídeo e carrossel, e o envio aceita "PDF, PPT, PPTX, DOC or DOCX, up to 100MB", o que bate com os tipos de arquivo e o limite de tamanho do próprio LinkedIn. As opções do LinkedIn incluem um campo de título do documento, descrito no editor como "Shown above the carousel in the LinkedIn feed". O texto do AdaptlyPost não informa um limite de páginas próprio, então vale o limite de 300 páginas do LinkedIn. A página do agendador de posts do LinkedIn explica como conectar um perfil ou página por OAuth e colocar posts na fila, e nosso guia sobre como agendar posts no LinkedIn compara as opções de agendamento.

Perguntas frequentes

Quais tipos de arquivo um post de documento no LinkedIn aceita?

O LinkedIn aceita arquivos PPT, PPTX, DOC, DOCX e PDF em posts de documento. A Documents API lista esses cinco formatos e nenhum outro. O PDF é a escolha mais segura, porque fixa fontes e layout antes de o LinkedIn processar o arquivo.

Qual o tamanho máximo de um documento no LinkedIn?

O LinkedIn limita um documento a 100MB e 300 páginas. Os dois limites vêm da referência da Documents API. A definição do status PROCESSING_FAILED cita "file size too large" como uma das causas.

Um carrossel do LinkedIn é a mesma coisa que um post de documento?

Em posts orgânicos, o carrossel deslizável de que as pessoas falam é um post de documento. A API do LinkedIn reserva o tipo de conteúdo Carousel para anúncios patrocinados e o marca como indisponível para posts orgânicos. Um post orgânico com várias fotos é um post MultiImage, que é outro formato.

Um post de documento no LinkedIn pode ser publicado pela API?

Sim. Você envia o arquivo pela ação initializeUpload da Documents API, que retorna uma URN de documento, e depois cria o post com POST /rest/posts, definindo essa URN como content.media.id. A Documents API não aceita SYNCHRONOUS_UPLOAD, então o arquivo sempre sobe pela URL de envio antes de o post ser criado.

O que é o título em um post de documento no LinkedIn?

O título é um campo separado, content.media.title, que pertence ao documento e não ao texto do post. A requisição de exemplo do LinkedIn o define como "Example.pdf". O editor do AdaptlyPost descreve o campo de título do documento como "Shown above the carousel in the LinkedIn feed".

Uma página de empresa pode publicar um post de documento no LinkedIn?

Sim. Um post de documento de página de empresa exige que quem chama tenha permissões ADMIN ou DSC na página, e o documento precisa ser enviado com a URN da organização como owner. Um membro sem essas permissões recebe um 403 da Documents API.

O que verificar antes de reenviar um documento do LinkedIn que falhou?

Verifique o arquivo contra os dois limites do LinkedIn, o teto de 100MB e o de 300 páginas, porque o status PROCESSING_FAILED junta erros do arquivo e falhas do próprio LinkedIn sob um único status. Se o arquivo passar nessa checagem, envie de novo.

Quais scopes da API do LinkedIn cobrem posts de documento?

w_member_social publica um documento em nome do membro autenticado, e w_organization_social publica em nome de uma página de empresa, restrito ao admin da página, ao DSC poster ou ao content admin. O scope necessário depende de qual URN de dono você define no upload.

O dwell time vale para posts de documento no LinkedIn?

Um post de documento é um update de feed como qualquer outro, então o relógio de dwell time do LinkedIn começa a contar assim que pelo menos metade dele fica visível durante a rolagem. A primeira página do documento é o que aparece na tela quando esse relógio começa, por isso o texto recomenda colocar ali o motivo para abrir o documento.

O AdaptlyPost aplica o limite de 300 páginas do LinkedIn nos posts de documento?

O composer do AdaptlyPost não define um limite de páginas próprio para documentos, então o teto de 300 páginas do LinkedIn é o que vale. O composer condiz com os tipos de arquivo e o limite de 100MB do LinkedIn.