Pular para o conteúdo principal
A API do LinkedIn tem os seguintes requisitos e restrições:
  • O campo post aceita até 3.000 caracteres.
  • O LinkedIn gerará automaticamente a prévia do link na publicação, a menos que haja uma imagem ou vídeo incluído. No exemplo acima, a imagem será exibida. Remover a imagem fará com que a prévia do link apareça. Se a prévia do link não puder ser recuperada, a publicação ainda será publicada e um campo linkPreviewFailed: true será retornado na resposta de /post.
  • As hashtags são clicáveis no LinkedIn. Use o símbolo # para especificar uma hashtag do LinkedIn.
  • Se estiver publicando um vídeo que não termina em uma extensão de vídeo conhecida, como mp4, use o parâmetro isVideo. Consulte o endpoint /post para detalhes.
  • O processamento de vídeos no LinkedIn leva vários minutos. Aguarde antes de tentar a URL de compartilhamento ou obter analytics de vídeo.
  • O LinkedIn limita 150 publicações por dia por conta do LinkedIn.
  • Publicar em grupos do LinkedIn não é suportado.
  • O LinkedIn também suporta envio de mídia sem texto de publicação. Se você não quiser incluir texto na publicação, envie uma String vazia post: "".
  • Você pode vincular uma company page ou uma conta pessoal do LinkedIn.
  • Consulte as Diretrizes de mídia do LinkedIn e a Autorização do LinkedIn para mais informações.
Você deve ser um “Super Admin” ou “Content Admin” para conectar uma company page do LinkedIn.

Publicando no LinkedIn

JSON para uma publicação básica com link e imagem no LinkedIn:
LinkedIn Post

Opções do LinkedIn

Você pode definir opções adicionais para uma publicação usando o parâmetro linkedInOptions.
LinkedIn Options
As opções do LinkedIn são campos opcionais que podem ser usados para controlar a publicação.
altText
array of strings
O texto alternativo das imagens, para acessibilidade e leitores de tela.Consulte Texto alternativo do LinkedIn para mais informações.
disableShare
boolean
padrão:false
Desabilita a capacidade dos usuários de recompartilharem a publicação do LinkedIn.Consulte Desabilitar compartilhamento no LinkedIn para mais informações.
targeting
object
Direcione suas publicações orgânicas para grupos específicos por países, indústria, cargo e muito mais.Requer pelo menos 300 seguidores no público-alvo.Consulte Segmentação de público no LinkedIn para mais informações.
thumbNail
string
A thumbnail de um vídeo. Deve ser PNG ou JPG, com as mesmas dimensões do vídeo, com menos de 10MB. A URL deve terminar em .png ou .jpg.Consulte Thumbnail de vídeo do LinkedIn para mais informações.
title
string
O título de um documento ao publicar arquivos PPT, PPTX, DOC, DOCX ou PDF. Tamanho máximo: 400 caracteres.Se não for especificado, o nome do arquivo é utilizado.Consulte Documentos do LinkedIn para mais informações.
titles
array of strings
Título ou legendas de mídia para imagens ou vídeos do LinkedIn.Cada título corresponde a uma URL de mídia na ordem.Consulte Títulos de mídia do LinkedIn para mais informações.
visibility
string
padrão:"public"
A visibilidade da publicação.Valores: public, connections ou loggedin.Consulte Visibilidade de publicação do LinkedIn para mais informações.

Texto alternativo

Adicione texto alternativo (alt text) do LinkedIn a uma imagem do LinkedIn. O alt text do LinkedIn é um recurso de acessibilidade usado para fornecer informações adicionais ao usuário e para leitores de tela. O LinkedIn não suporta altText em vídeos ou documentos. Use altText no objeto linkedInOptions.
LinkedIn Alt Text
Cada alt text deve corresponder a uma imagem no array mediaUrls. O alt text será aplicado a cada imagem na ordem.

Segmentação de público

O LinkedIn permite direcionar suas publicações orgânicas para grupos específicos de usuários. Você pode direcionar por países, indústria, cargo e muito mais.
A segmentação do LinkedIn exige pelo menos 300 seguidores no público-alvo. Por exemplo, se você tiver 400 seguidores e direcionar apenas usuários do país US, mas apenas 200 dos seus seguidores estiverem nos EUA, a segmentação falhará porque o público é muito pequeno.
Use o objeto targeting no objeto linkedInOptions:
LinkedIn Audience Targeting
As opções de segmentação disponíveis estão listadas nos seguintes arquivos JSON:

Renovação de autorização

O LinkedIn deve ser reautorizado todo ano via página Social Accounts.
  • Uma notificação por e-mail e webhook de ação social será enviada 15 dias antes da expiração da autorização.
  • A data de renovação necessária e os dias restantes podem ser recuperados do endpoint /user.
  • O usuário verá em sua página de vinculação de contas sociais um alerta e um botão de renovação 30 dias antes da expiração.

Limites de caracteres

Consulte Limites de caracteres do LinkedIn para mais informações.

Desabilitar compartilhamento

Você pode desabilitar a capacidade dos usuários de recompartilharem a publicação do LinkedIn definindo o campo disableShare como true no objeto linkedInOptions:
LinkedIn Disable Share

Documentos

Use a API para publicar um documento no LinkedIn. Formatos de arquivo suportados: PPT, PPTX, DOC, DOCX e PDF. Certifique-se de que o documento tenha menos de 100 MB de tamanho e não exceda 300 páginas. Abaixo, um exemplo de código demonstrando como publicar um documento PPTX com título:
LinkedIn Document Post
A URL da mídia fornecida deve terminar em uma extensão de documento conhecida: ppt, pptx, doc, docx ou pdf.

Menções no LinkedIn

Você pode mencionar outras organizações do LinkedIn, ou seja, company pages, ou perfis de membros, ou seja, páginas de perfil individuais, em suas publicações. O Ayrshare tenta resolver a @mention fazendo uma busca pelo handle. Se a @mention não for encontrada, o @ será removido da publicação, pois o LinkedIn não aceita publicações com menções não resolvidas. Perfis individuais do LinkedIn não podem ser mencionados.
Se qualquer menção em uma publicação do LinkedIn não puder ser resolvida (devido a configurações de privacidade, restrições de conta ou outras limitações da plataforma), o LinkedIn pode falhar em renderizar todas as menções nessa publicação como links clicáveis. Isso é comportamento da plataforma do LinkedIn e não um problema da API. Para evitar isso, certifique-se de que todos os usuários e organizações mencionados permitem menções da sua organização, ou considere postar menções separadamente para isolar quaisquer menções problemáticas.
Revise as regras importantes sobre menções.

Perfis de organização

Mencione outra organização do LinkedIn adicionando @handle no texto da publicação. O @handle é o nome da empresa ou organização. Você pode mencionar em publicações, comentários e responder a comentários. Por exemplo,
LinkedIn Mention

Perfis de membros

Mencione outro perfil de membro do LinkedIn adicionando @vanity_name ou @[John Smith] no texto da publicação.
  1. @vanity_name é o vanity name do perfil do membro. Por exemplo, na URL do perfil do membro https://www.linkedin.com/in/vanity_name/, o vanity name é vanity_name.
  2. @[John Smith] é o nome completo da pessoa. Por exemplo, se o nome completo da pessoa for John Smith, a menção seria @[John Smith].
Você pode mencionar em publicações, comentários e responder a comentários.
LinkedIn Mention
No exemplo acima, John Smith e Ava Smith serão mencionados na publicação — o primeiro usando o nome completo e o segundo usando o vanity name. Notas importantes:
  1. Você precisa ter uma company page do LinkedIn conectada à sua conta do Ayrshare para mencionar perfis de membros. Se você conectar sua própria conta pessoal do LinkedIn, não poderá mencionar perfis de outras pessoas.
  2. O LinkedIn só permite mencionar pessoas que sigam sua organização / company page.

Títulos de mídia

Adicione título ou legendas de mídia a imagens ou vídeos do LinkedIn. Use titles no objeto linkedInOptions.
LinkedIn Media Titles
Cada título deve corresponder a uma imagem ou vídeo no array mediaUrls. O título será aplicado a cada imagem ou vídeo na ordem.

Publicações com múltiplas imagens

Você pode publicar até 9 URLs de imagem em mediaUrls no LinkedIn.
LinkedIn Multi Image Post
O LinkedIn ainda não suporta imagens em carrossel para publicações orgânicas.

Visibilidade da publicação

O LinkedIn permite controlar a visibilidade de suas publicações. Você pode definir a visibilidade como pública, somente para conexões ou somente para usuários logados. Se nenhuma visibilidade for especificada, a publicação será “public” e visível para todos os usuários do LinkedIn.
  • public: A publicação será visível para todos os usuários do LinkedIn. Disponível tanto para company pages quanto contas pessoais do LinkedIn conectadas. Padrão se nenhuma visibilidade for especificada.
  • connections: A publicação será visível para a rede de 1º grau do proprietário (User Profile). Disponível apenas para contas pessoais do LinkedIn conectadas.
  • loggedin: A publicação será visível apenas para usuários logados do LinkedIn. Disponível tanto para company pages quanto contas pessoais do LinkedIn conectadas.
Use o campo visibility no objeto linkedInOptions:
LinkedIn Post Visibility

Permissões de publicação de vídeo

No LinkedIn, apenas usuários com permissões específicas podem publicar vídeos em company pages:
  1. Usuários com permissões de Admin.
  2. Usuários com permissões de Direct Sponsored Content (DSC).
Os Content Administrators não têm a capacidade de publicar vídeos em company pages do LinkedIn.

Thumbnail de vídeo

Defina uma thumbnail do LinkedIn para um vídeo. Envie uma URL remota de um arquivo PNG ou JPG com as mesmas dimensões do vídeo e menos de 10 MB. A URL deve terminar em .png ou .jpg. Use thumbNail no objeto linkedInOptions.
LinkedIn Video Thumbnail
Veja aqui mais exemplos de uso da API do LinkedIn.