> ## 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. # LinkedIn API > Параметри для публікації за допомогою LinkedIn API LinkedIn API має такі вимоги та обмеження: Ви повинні бути "Super Admin" або "Content Admin", щоб під'єднати сторінку компанії LinkedIn.{" "} ## Публікація в LinkedIn JSON для базового допису з посиланням та зображенням у LinkedIn: ```json LinkedIn Post theme={"system"} { "post": "The best LinkedIn post ever #best https://www.linkedin.com", // порожній рядок дозволено "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["linkedin"] } ``` ## Параметри LinkedIn Ви можете встановити додаткові параметри для допису, використовуючи параметр `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" } } ``` Параметри LinkedIn — це опціональні поля, які можна використовувати для керування дописом. Альтернативний текст зображень для доступності та програм зчитування з екрана. Для отримання додаткової інформації див. [LinkedIn Alternative Text](/apis/post/social-networks/linkedin#alternative-text). Вимкнути можливість користувачів повторно ділитися дописом LinkedIn. Для отримання додаткової інформації див. [LinkedIn Disable Share](/apis/post/social-networks/linkedin#disable-share). Таргетуйте Ваші органічні дописи на конкретні групи за країнами, галуззю, посадою та іншим. Вимагає принаймні 300 підписників у цільовій аудиторії. Для отримання додаткової інформації див. [LinkedIn Audience Targeting](/apis/post/social-networks/linkedin#audience-targeting). Мініатюра відео. Має бути PNG або JPG, ті ж розміри, що й відео, менше 10 МБ. URL повинен закінчуватися на .png або .jpg. Для отримання додаткової інформації див. [LinkedIn Video Thumbnail](/apis/post/social-networks/linkedin#video-thumbnail). Заголовок документа при публікації файлів PPT, PPTX, DOC, DOCX або PDF. Максимальна довжина: 400 символів. Якщо не вказано, використовується ім'я файлу. Для отримання додаткової інформації див. [LinkedIn Documents](/apis/post/social-networks/linkedin#documents). Заголовки або медіа-підписи до зображень або відео LinkedIn. Кожен заголовок відповідає URL медіа за порядком. Для отримання додаткової інформації див. [LinkedIn Media Titles](/apis/post/social-networks/linkedin#media-titles). Видимість допису. Значення: `public`, `connections` або `loggedin`. Для отримання додаткової інформації див. [LinkedIn Post Visibility](/apis/post/social-networks/linkedin#post-visibility). ## Alternative Text Додайте LinkedIn alternative text, також відомий як LinkedIn alt text, до зображення LinkedIn. LinkedIn alt text — це функція доступності, що використовується для додаткової інформації користувача та програм зчитування з екрана. LinkedIn не підтримує altText для відео або документів. Використовуйте `altText` в об'єкті `linkedInOptions`. ```json LinkedIn Alt Text theme={"system"} { "linkedInOptions": { "altText": ["This is my best pic", "😃 here is the next one"] // Масив Alt Texts } } ``` Кожен alt text повинен відповідати зображенню в масиві `mediaUrls`. Alt text буде застосовано до кожного зображення за порядком. ## Audience Targeting LinkedIn дозволяє Вам таргетувати Ваші органічні дописи на конкретні групи користувачів. Ви можете таргетувати за країнами, галуззю, посадою та іншим. Таргетинг LinkedIn вимагає принаймні **300 підписників у цільовій аудиторії**. Наприклад, якщо у Вас 400 підписників, а Ви таргетуєте лише користувачів у країні US, але лише 200 Ваших підписників у US, таргетинг зазнає невдачі, оскільки аудиторія занадто мала. Використовуйте об'єкт `targeting` в об'єкті `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"] } } } ``` Доступні параметри таргетингу перелічено в наступних файлах JSON: ## Оновлення авторизації LinkedIn необхідно повторно авторизувати *щороку* через сторінку Social Accounts. ## Обмеження символів Для отримання додаткової інформації див. [Обмеження символів LinkedIn](/help-center/technical-support/character_limits#linkedin-character-limits). ## Disable Share Ви можете вимкнути можливість користувачів повторно ділитися дописом LinkedIn, встановивши поле `disableShare` у `true` в об'єкті `linkedInOptions`: ```json LinkedIn Disable Share theme={"system"} { "linkedInOptions": { "disableShare": true } } ``` ## Documents Використовуйте API для публікації документа в LinkedIn. Підтримувані формати файлів: PPT, PPTX, DOC, DOCX та PDF. Переконайтеся, що документ має розмір менше 100 МБ і не перевищує 300 сторінок. Нижче наведено зразок коду, що демонструє, як опублікувати документ PPTX із заголовком: ```json LinkedIn Document Post theme={"system"} { "post": "What a great document", "platforms": ["linkedin"], "linkedInOptions": { "title": "Sample PPTX" // опціонально. Якщо не вказано, використовується ім'я файлу. }, "mediaUrls": ["https://scholar.harvard.edu/files/torman_personal/files/samplepptx.pptx"] } ``` Наданий URL медіа має закінчуватися відомим розширенням документа: ppt, pptx, doc, docx або pdf. ## Згадування LinkedIn Ви можете згадувати інші організації LinkedIn, тобто сторінки компаній, або профілі учасників, тобто окремі сторінки профілів, у своїх дописах. Ayrshare намагається розкрити @mention, здійснюючи пошук за handle. Якщо @mention не знайдено, @ буде видалено з допису, оскільки LinkedIn не приймає дописи з нерозкритими згадуваннями. Особисті профілі LinkedIn не можна згадувати. Якщо будь-яке згадування в дописі LinkedIn не може бути розкрито (через налаштування конфіденційності, обмеження облікового запису або інші обмеження платформи), LinkedIn може не відобразити всі згадування в цьому дописі як клікабельні посилання. Це поведінка платформи LinkedIn, а не проблема API. Щоб уникнути цього, переконайтеся, що всі згадані користувачі та організації дозволяють згадування від Вашої організації, або розгляньте можливість публікації згадувань окремо, щоб ізолювати будь-які проблемні згадування. Будь ласка, перегляньте [важливі правила](/testing/post-verification#mentions) щодо згадувань. ### Профілі організацій Згадайте handle іншої організації LinkedIn, додавши `@handle` у текст допису. `@handle` — це назва компанії або організації. Ви можете згадувати в дописах, коментарях і відповідях на коментарі. Наприклад, ```json LinkedIn Mention theme={"system"} { "post": "The best social media API @ayrshare ever!", "platforms": ["linkedin"] } ``` ### Профілі учасників Згадайте профіль іншого учасника LinkedIn, додавши `@vanity_name` або `@[John Smith]` у текст допису. 1. `@vanity_name` — це vanity name профілю учасника. Наприклад, у URL профілю учасника `https://www.linkedin.com/in/vanity_name/`, vanity name — `vanity_name`. 2. `@[John Smith]` — це повне ім'я людини. Наприклад, якщо повне ім'я людини `John Smith`, згадування буде `@[John Smith]`. Ви можете згадувати в дописах, коментарях і відповідях на коментарі. ```json LinkedIn Mention theme={"system"} { "post": "The best social media API @[John Smith] and @ava_smith ever!", "platforms": ["linkedin"] } ``` У наведеному вище прикладі John Smith та Ava Smith будуть згадані в дописі — перший за їхнім повним ім'ям, а другий за їхнім vanity name. **Важливі примітки:** 1. У Вас має бути під'єднана сторінка компанії LinkedIn до Вашого облікового запису Ayrshare, щоб згадувати профілі учасників. Якщо Ви під'єднуєте свій особистий обліковий запис LinkedIn, Ви не зможете згадувати профілі інших людей. 2. LinkedIn дозволяє згадувати лише людей, які підписуються на Вашу організацію / сторінку компанії. ## Media Titles Додайте заголовки або медіа-підписи до зображень або відео LinkedIn. Використовуйте `titles` в об'єкті `linkedInOptions`. ```json LinkedIn Media Titles theme={"system"} { "linkedInOptions": { "titles": ["This is an amazing video", "😃 here is the next one"] // Масив Alt Texts } } ``` Кожен заголовок повинен відповідати зображенню або відео в масиві `mediaUrls`. Заголовок буде застосовано до кожного зображення або відео за порядком. ## Multi Image Posts Ви можете публікувати до *9 URL зображень* у `mediaUrls` до LinkedIn. ```json LinkedIn Multi Image Post theme={"system"} { "mediaUrls": ["https://url1", ..., "https://url9"] } ``` LinkedIn поки що не підтримує каруселі зображень для органічних дописів. ## Post Visibility LinkedIn дозволяє Вам контролювати видимість Ваших дописів. Ви можете встановити видимість як публічну, лише для зв'язків або лише для авторизованих користувачів. Якщо видимість не вказана, допис буде "public" і видимий для всіх користувачів LinkedIn. Використовуйте поле `visibility` в об'єкті `linkedInOptions`: ```json LinkedIn Post Visibility theme={"system"} { "linkedInOptions": { "visibility": "public" // "public", "connections" або "loggedin" } } ``` ## Дозволи на публікацію відео У LinkedIn лише користувачі з певними дозволами можуть публікувати відео на сторінках компаній: 1. Користувачі з дозволами Admin. 2. Користувачі з дозволами Direct Sponsored Content (DSC). Content Administrators не мають можливості публікувати відео на сторінках компаній LinkedIn. ## Video Thumbnail Встановіть мініатюру LinkedIn для відео. Надішліть віддалений URL файлу PNG або JPG, що має ті самі розміри, що й відео, і менше 10 МБ. URL повинен закінчуватися на .png або .jpg. Використовуйте `thumbNail` в об'єкті `linkedInOptions`. ```json LinkedIn Video Thumbnail theme={"system"} { "linkedInOptions": { "thumbNail": "https://octodex.github.com/images/Fintechtocat.png" } } ``` Для отримання додаткових [прикладів використання LinkedIn API](https://www.ayrshare.com/how-to-post-and-get-analytics-with-the-linkedin-api#linkedin-api-examples) див. тут.