> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # API do LinkedIn > Opções para publicar usando a API do LinkedIn A API do LinkedIn tem os seguintes requisitos e restriçõ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: ```json LinkedIn Post theme={"system"} { "post": "The best LinkedIn post ever #best https://www.linkedin.com", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["linkedin"] } ``` ## Opções do LinkedIn Você pode definir opções adicionais para uma publicação usando o parâmetro `linkedInOptions`. ```json LinkedIn Options theme={"system"} { "linkedInOptions": { "altText": ["This is my best pic", "😃 here is the next one"], "disableShare": true, "targeting": { "countries": ["US", "IN", "DE", "GB"], "seniorities": ["Senior", "VP"], "degrees": ["Master of Digital Design", "Bachelor of Engineering"], "fieldsOfStudy": ["Consumer Economics", "Computer Games and Programming Skills"], "industries": ["Telecommunications Carriers", "Banking"], "jobFunctions": ["Information Technology", "Entrepreneurship"], "staffCountRanges": ["size_51_to_200", "size_5001_to_10000"] }, "thumbNail": "https://example.com/thumbnail.jpg", "title": "Sample PPTX", "titles": ["This is an amazing video", "😃 here is the next one"], "visibility": "public" } } ``` As opções do LinkedIn são campos opcionais que podem ser usados para controlar a publicação. O texto alternativo das imagens, para acessibilidade e leitores de tela. Consulte [Texto alternativo do LinkedIn](/apis/post/social-networks/linkedin#alternative-text) para mais informações. Desabilita a capacidade dos usuários de recompartilharem a publicação do LinkedIn. Consulte [Desabilitar compartilhamento no LinkedIn](/apis/post/social-networks/linkedin#disable-share) para mais informações. 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](/apis/post/social-networks/linkedin#audience-targeting) para mais informações. 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](/apis/post/social-networks/linkedin#video-thumbnail) para mais informações. 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](/apis/post/social-networks/linkedin#documents) para mais informações. 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](/apis/post/social-networks/linkedin#media-titles) para mais informações. A visibilidade da publicação. Valores: `public`, `connections` ou `loggedin`. Consulte [Visibilidade de publicação do LinkedIn](/apis/post/social-networks/linkedin#post-visibility) 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`. ```json LinkedIn Alt Text theme={"system"} { "linkedInOptions": { "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts } } ``` 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`: ```json LinkedIn Audience Targeting theme={"system"} { "linkedInOptions": { "targeting": { "countries": ["US", "IN", "DE", "GB"], "seniorities": ["Senior", "VP"], "degrees": ["Master of Digital Design", "Bachelor of Engineering"], "fieldsOfStudy": ["Consumer Economics", "Computer Games and Programming Skills"], "industries": ["Telecommunications Carriers", "Banking"], "jobFunctions": ["Information Technology", "Entrepreneurship"], "staffCountRanges": ["size_51_to_200", "size_5001_to_10000"] } } } ``` 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. ## Limites de caracteres Consulte [Limites de caracteres do LinkedIn](/help-center/technical-support/character_limits#linkedin-character-limits) 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`: ```json LinkedIn Disable Share theme={"system"} { "linkedInOptions": { "disableShare": true } } ``` ## 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: ```json LinkedIn Document Post theme={"system"} { "post": "What a great document", "platforms": ["linkedin"], "linkedInOptions": { "title": "Sample PPTX" // optional. If not specified, the file name used. }, "mediaUrls": ["https://scholar.harvard.edu/files/torman_personal/files/samplepptx.pptx"] } ``` 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](/testing/post-verification#mentions) 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, ```json LinkedIn Mention theme={"system"} { "post": "The best social media API @ayrshare ever!", "platforms": ["linkedin"] } ``` ### 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. ```json LinkedIn Mention theme={"system"} { "post": "The best social media API @[John Smith] and @ava_smith ever!", "platforms": ["linkedin"] } ``` 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`. ```json LinkedIn Media Titles theme={"system"} { "linkedInOptions": { "titles": ["This is an amazing video", "😃 here is the next one"] // Array of Alt Texts } } ``` 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. ```json LinkedIn Multi Image Post theme={"system"} { "mediaUrls": ["https://url1", ..., "https://url9"] } ``` 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. Use o campo `visibility` no objeto `linkedInOptions`: ```json LinkedIn Post Visibility theme={"system"} { "linkedInOptions": { "visibility": "public" // "public", "connections", or "loggedin" } } ``` ## 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`. ```json LinkedIn Video Thumbnail theme={"system"} { "linkedInOptions": { "thumbNail": "https://octodex.github.com/images/Fintechtocat.png" } } ``` Veja aqui mais [exemplos de uso da API do LinkedIn](https://www.ayrshare.com/how-to-post-and-get-analytics-with-the-linkedin-api#linkedin-api-examples).