Qué es una publicación de documento de LinkedIn y cómo procesa LinkedIn el archivo

¿Qué es una publicación de documento de LinkedIn?

En esencia, una publicación de documento de LinkedIn es una publicación del feed cuyo contenido es un archivo PDF, PowerPoint o Word subido, que el feed muestra como un conjunto de páginas que el lector recorre dentro de la publicación. La documentación para desarrolladores de LinkedIn la trata como un tipo de contenido propio. La referencia de la Posts API dice: "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." Primero va el archivo y después la publicación.

LinkedIn fija los límites del archivo en la página 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." Esas dos frases son toda la especificación que LinkedIn publica sobre el archivo.

Propiedad	Valor	Fuente
Tipos de archivo	PPT, PPTX, DOC, DOCX, PDF	Documents API
Tamaño máximo del archivo	100MB	Documents API
Páginas máximas	300	Documents API
Identificador del recurso	urn:li:document:{id}	Posts API
Publicación orgánica	Admitida	Posts API
Publicación patrocinada	Admitida	Posts API
Tamaño o proporción de página	No documentado	Ninguna de las dos

La última fila importa para el diseño. Las páginas para desarrolladores de LinkedIn no dan dimensiones de página ni proporción para los documentos. Cualquier tamaño en píxeles que leas para las páginas de un documento sale de las pruebas de alguien, no de la especificación de LinkedIn.

¿Una publicación de documento de LinkedIn es lo mismo que un carrusel de LinkedIn?

Una publicación de documento de LinkedIn es lo que casi todo el mundo llama "carrusel de LinkedIn", pero la API de LinkedIn usa la palabra carrusel para otro formato que las publicaciones orgánicas no pueden usar. La referencia de la Posts API tiene una tabla de tipos de contenido con una columna para publicaciones orgánicas y otra para patrocinadas, y las filas discrepan justo en este punto.

Tipo de contenido	Orgánico (no patrocinado)	Patrocinado
Documents	Sí	Sí
Carousels	No	Sí
MultiImage	Sí	No
Images	Sí	Sí
Videos	Sí	Sí

Lee con atención la fila Carousels. En el vocabulario de LinkedIn, un carrusel es una unidad de anuncio patrocinado. Una publicación orgánica que se desliza de lado es una publicación de documento, y una publicación orgánica con varias fotos es una publicación MultiImage. Son dos formatos distintos con dos flujos de subida distintos.

Un programador que dice admitir "carruseles de LinkedIn" orgánicos se refiere a publicaciones de documento o a publicaciones MultiImage, porque LinkedIn no permite el tipo Carousel fuera de los anuncios. Nuestra guía general sobre publicaciones en carrusel explica cómo funciona el formato deslizable en las demás redes, donde "carrusel" significa un conjunto de imágenes.

¿Qué archivo deberías subir para una publicación de documento de LinkedIn?

Sube un PDF para una publicación de documento de LinkedIn, porque un PDF fija tus fuentes y tu maquetación antes de que LinkedIn toque el archivo. LinkedIn también acepta PPT, PPTX, DOC y DOCX, pero tiene que procesar cada subida antes de que el archivo pueda aparecer en una publicación. La Documents API describe el estado PROCESSING como "Asset is processing to generate missing artifacts." La respuesta de ejemplo de esa página devuelve una downloadUrl cuya ruta contiene ads-document-pdf-analyzed, un nombre de ruta que sugiere que LinkedIn guarda una versión en PDF de lo que hayas enviado.

Si subes un archivo de PowerPoint, cualquier conversión ocurre del lado de LinkedIn, con las fuentes que LinkedIn tenga. Si subes un PDF, la conversión ya ocurrió en tu equipo, donde viste el resultado. LinkedIn no documenta cómo renderiza las fuentes que faltan en un DOCX o un PPTX.

De los dos límites, 100MB es el que alcanzan primero las diapositivas cargadas de imágenes, porque un PDF exportado con calidad de impresión conserva cada imagen a resolución completa. El tope de 300 páginas queda muy por encima de lo que un lector va a recorrer en un feed.

PDF o PowerPoint y Word

PDF

• Las fuentes y el diseño quedan fijados antes de subir el archivo
• Lo que ves en el archivo es lo que recibe LinkedIn
• Coincide con el nombre de ruta ads-document-pdf-analyzed en downloadUrl

PPT, PPTX, DOC, DOCX

• LinkedIn convierte el archivo en su propio lado
• No está documentado cómo se procesan las fuentes que faltan
• Sigue limitado a 100MB y 300 páginas

¿Cómo se publica una publicación de documento a través de la API de LinkedIn?

Una publicación de documento se publica en dos fases: subes el archivo a la Documents API y recibes un URN de documento, y después creas una publicación que hace referencia a ese URN. La página de la Documents API recorre cada llamada.

1. Llama a POST /rest/documents?action=initializeUpload con un initializeUploadRequest que indique el owner, ya sea un URN de persona o un URN de organización.
2. Lee la respuesta. Devuelve una uploadUrl, una marca de tiempo uploadUrlExpiresAt y el URN document con la forma urn:li:document:{id}.
3. Sube el archivo a la uploadUrl. El ejemplo de LinkedIn usa curl --upload-file con un bearer token y recibe HTTP/2 201.
4. Llama a GET /rest/documents/{document URN} y lee status hasta que diga AVAILABLE.
5. Llama a POST /rest/posts con content.media.id igual al URN del documento y content.media.title igual al título que quieras en el documento, además de commentary, visibility, distribution y lifecycleState de la publicación.

La página añade una restricción: "SYNCHRONOUS_UPLOAD is not supported in Documents API." El flujo es el mismo que el de las imágenes, y nuestro recorrido por cómo initializeUpload de LinkedIn convierte un archivo en un URN de imagen muestra el mismo patrón con sus tablas de errores.

La página de LinkedIn no dice si una publicación puede hacer referencia a un documento que todavía se está procesando. Esperar a AVAILABLE en el paso 4 es el orden que nunca depende de esa respuesta.

¿Qué significan los valores de estado de un documento de LinkedIn?

Un recurso de documento de LinkedIn pasa por cuatro valores de estado que te dicen si el archivo ya puede ir en una publicación. La Documents API define cada uno en su tabla de esquema.

Estado	Definición 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 es el estado para el que hay que planificar. Su definición mete en un mismo valor tus errores, como un archivo de 120MB o un formato no admitido, y las caídas del propio LinkedIn. El estado por sí solo no te dice qué lado falló. Comprueba primero el archivo frente a los límites. Si el archivo los cumple, vuelve a subirlo. Cuando una publicación de documento programada no sale, esa separación entre problemas del archivo y problemas de la plataforma es lo primero que hay que revisar, y nuestra guía sobre publicaciones programadas de LinkedIn que no funcionan cubre las demás causas.

¿Quién puede publicar una publicación de documento de LinkedIn?

Un miembro de LinkedIn puede publicar una publicación de documento en su propio perfil, y un administrador de una página de empresa puede publicarla en la página. La Documents API comprueba los permisos frente al propietario que indicaste al subir el archivo. "For documents with company URN owners, the caller must have ADMIN or DSC permissions for the company page." Para propietarios que son personas, "the caller must match the document owner."

Los scopes siguen la misma división. w_member_social publica en nombre del miembro autenticado, y w_organization_social publica en nombre de una organización, algo que LinkedIn restringe a "the company admin, DSC poster, or content admin." Quien llama sin el permiso adecuado recibe un 403 con el mensaje "Accessing this document resource is forbidden. Please check your permissions for this resource."

Decide el propietario antes de subir el archivo. La comprobación de permisos se hace frente al propietario indicado en initializeUpload, así que un archivo pensado para una publicación de página de empresa se sube con el URN de la organización como propietario, no con el URN del miembro que hace la subida.

¿Cómo preparas un archivo para una publicación de documento de LinkedIn?

Prepara un archivo para una publicación de documento de LinkedIn exportándolo a PDF, comprobándolo frente a los dos límites de LinkedIn y decidiendo el título del documento antes de programarla.

1. Exporta la presentación o el documento a PDF desde la aplicación en la que lo diseñaste.
2. Comprueba que el archivo pese menos de 100MB. Si no, comprime las imágenes dentro del PDF.
3. Comprueba que tenga menos de 300 páginas.
4. Abre el PDF y recórrelo una vez. Lo que ves es con lo que LinkedIn va a trabajar.
5. Escribe el título del documento aparte del texto de la publicación. La API lo guarda en content.media.title, separado de commentary.
6. Pon el motivo para abrir el documento en la primera página, ya que la primera página es lo que se ve antes de que nadie lo recorra.

El paso 6 enlaza con cómo mide LinkedIn la atención. El dwell time del feed de LinkedIn empieza a contar cuando "at least half of a feed update is visible as a member scrolls through their feed," según el equipo de ingeniería de LinkedIn, y una publicación de documento es una actualización del feed como cualquier otra. La primera página es la parte del documento que está en pantalla cuando arranca ese reloj.

¿Puedes programar una publicación de documento de LinkedIn con AdaptlyPost?

AdaptlyPost programa publicaciones de documento de LinkedIn en perfiles y páginas de empresa de LinkedIn conectados. En el editor, Document es uno de los tipos de contenido junto a las publicaciones de texto, imagen, vídeo y carrusel, y la subida acepta "PDF, PPT, PPTX, DOC or DOCX, up to 100MB", lo que coincide con los tipos de archivo y el tope de tamaño del propio LinkedIn. Las opciones de LinkedIn incluyen un campo para el título del documento, que el editor describe como "Shown above the carousel in the LinkedIn feed". Los textos de AdaptlyPost no indican un límite de páginas propio, así que se aplica el tope de 300 páginas de LinkedIn. La página del programador de publicaciones de LinkedIn explica cómo conectar un perfil o una página por OAuth y poner publicaciones en cola, y nuestra guía sobre cómo programar publicaciones en LinkedIn compara las opciones de programación.

Preguntas frecuentes

¿Qué tipos de archivo puede usar una publicación de documento de LinkedIn?

LinkedIn acepta archivos PPT, PPTX, DOC, DOCX y PDF para las publicaciones de documento. La Documents API enumera esos cinco formatos y ninguno más. El PDF es la opción más segura, porque fija las fuentes y la maquetación antes de que LinkedIn procese el archivo.

¿Cuánto puede ocupar un documento de LinkedIn?

LinkedIn limita un documento a 100MB y 300 páginas. Ambos límites vienen de la referencia de la Documents API. La definición del estado PROCESSING_FAILED cita "file size too large" como una de sus causas.

¿Un carrusel de LinkedIn es lo mismo que una publicación de documento?

En las publicaciones orgánicas, el carrusel deslizable del que habla la gente es una publicación de documento. La API de LinkedIn reserva el tipo de contenido Carousel para anuncios patrocinados y lo marca como no disponible para publicaciones orgánicas. Una publicación orgánica con varias fotos es una publicación MultiImage aparte.

¿Se puede publicar una publicación de documento de LinkedIn a través de la API?

Sí. Subes el archivo con la acción initializeUpload de la Documents API, que devuelve un URN de documento, y después creas la publicación con POST /rest/posts y pones ese URN como content.media.id. La Documents API no admite SYNCHRONOUS_UPLOAD, así que el archivo siempre se sube por la URL de subida antes de crear la publicación.

¿Qué es el título de una publicación de documento de LinkedIn?

El título es un campo aparte, content.media.title, que pertenece al documento y no al texto de la publicación. La petición de ejemplo de LinkedIn lo fija en "Example.pdf". El editor de AdaptlyPost describe su campo de título del documento como "Shown above the carousel in the LinkedIn feed".

¿Puede una página de empresa publicar una publicación de documento de LinkedIn?

Sí. Una publicación de documento en una página de empresa exige que quien llama tenga permisos ADMIN o DSC en la página, y el documento debe subirse con el URN de la organización como propietario. Un miembro sin esos permisos recibe un 403 de la Documents API.

¿Qué deberías revisar antes de volver a subir un documento de LinkedIn que falló?

Revisa el archivo contra los dos límites de LinkedIn, el tope de 100MB y el de 300 páginas, porque PROCESSING_FAILED agrupa los errores del archivo y los fallos propios de LinkedIn bajo un mismo estado. Si el archivo pasa esa revisión, súbelo de nuevo.

¿Qué scopes de la API de LinkedIn cubren las publicaciones de documento?

w_member_social publica un documento en nombre del miembro autenticado, y w_organization_social publica en nombre de una página de empresa, restringido al admin de la página, al DSC poster o al content admin. El scope que necesitas depende de qué URN de owner pongas al subir el archivo.

¿El dwell time se aplica a las publicaciones de documento de LinkedIn?

Una publicación de documento es una actualización de feed como cualquier otra, así que el reloj de dwell time de LinkedIn empieza a contar en cuanto al menos la mitad de ella es visible mientras alguien hace scroll. La primera página del documento es lo que está en pantalla cuando arranca ese reloj, por eso el texto recomienda poner ahí el motivo para abrir el documento.

¿AdaptlyPost aplica el límite de 300 páginas de LinkedIn en las publicaciones de documento?

El composer de AdaptlyPost no indica un límite de páginas propio para los documentos, así que el tope de 300 páginas de LinkedIn es el que rige. El composer sí coincide con los tipos de archivo y el límite de 100MB de LinkedIn.