> ## 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 > Các tùy chọn để đăng bài bằng LinkedIn API LinkedIn API có các yêu cầu và hạn chế sau: Bạn phải là "Super Admin" hoặc "Content Admin" để kết nối một trang công ty LinkedIn.{" "} ## Đăng bài lên LinkedIn JSON cho một bài đăng cơ bản với liên kết và hình ảnh lên 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"] } ``` ## Tùy chọn LinkedIn Bạn có thể đặt các tùy chọn bổ sung cho bài đăng bằng cách sử dụng tham số `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" } } ``` Các tùy chọn LinkedIn là các trường tùy chọn có thể được sử dụng để kiểm soát bài đăng. Văn bản thay thế của hình ảnh để hỗ trợ khả năng tiếp cận và trình đọc màn hình. Xem [Văn bản thay thế LinkedIn](/apis/post/social-networks/linkedin#alternative-text) để biết thêm thông tin. Vô hiệu hóa khả năng người dùng chia sẻ lại bài đăng LinkedIn. Xem [LinkedIn Disable Share](/apis/post/social-networks/linkedin#disable-share) để biết thêm thông tin. Nhắm mục tiêu các bài đăng tự nhiên đến các nhóm cụ thể theo quốc gia, ngành, chức danh, và nhiều hơn nữa. Yêu cầu ít nhất 300 người theo dõi trong đối tượng mục tiêu. Xem [LinkedIn Audience Targeting](/apis/post/social-networks/linkedin#audience-targeting) để biết thêm thông tin. Thumbnail của một video. Phải là PNG hoặc JPG, cùng kích thước với video, dưới 10MB. URL phải kết thúc bằng .png hoặc .jpg. Xem [LinkedIn Video Thumbnail](/apis/post/social-networks/linkedin#video-thumbnail) để biết thêm thông tin. Tiêu đề của một tài liệu khi đăng các file PPT, PPTX, DOC, DOCX, hoặc PDF. Độ dài tối đa: 400 ký tự. Nếu không được chỉ định, tên file sẽ được sử dụng. Xem [LinkedIn Documents](/apis/post/social-networks/linkedin#documents) để biết thêm thông tin. Tiêu đề hoặc chú thích phương tiện cho hình ảnh hoặc video LinkedIn. Mỗi tiêu đề tương ứng với một URL phương tiện theo thứ tự. Xem [LinkedIn Media Titles](/apis/post/social-networks/linkedin#media-titles) để biết thêm thông tin. Visibility của bài đăng. Các giá trị: `public`, `connections`, hoặc `loggedin`. Xem [LinkedIn Post Visibility](/apis/post/social-networks/linkedin#post-visibility) để biết thêm thông tin. ## Văn bản thay thế (Alt Text) Thêm văn bản thay thế LinkedIn, còn được gọi là LinkedIn alt text, vào một hình ảnh LinkedIn. Alt text LinkedIn là một tính năng trợ năng được sử dụng để cung cấp thông tin bổ sung cho người dùng và trình đọc màn hình. LinkedIn không hỗ trợ altText trên video hoặc tài liệu. Sử dụng `altText` trong đối tượng `linkedInOptions`. ```json LinkedIn Alt Text theme={"system"} { "linkedInOptions": { "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts } } ``` Mỗi alt text phải tương ứng với một hình ảnh trong mảng `mediaUrls`. Alt text sẽ được áp dụng cho từng hình ảnh theo thứ tự. ## Nhắm mục tiêu khán giả LinkedIn cho phép bạn nhắm mục tiêu các bài đăng tự nhiên đến các nhóm người dùng cụ thể. Bạn có thể nhắm mục tiêu theo quốc gia, ngành, chức danh, và nhiều hơn nữa. Việc nhắm mục tiêu LinkedIn yêu cầu ít nhất **300 người theo dõi trong đối tượng mục tiêu**. Ví dụ nếu bạn có 400 người theo dõi và nhắm mục tiêu chỉ những người dùng ở quốc gia US, nhưng chỉ 200 người theo dõi của bạn ở US, việc nhắm mục tiêu sẽ thất bại vì đối tượng quá nhỏ. Sử dụng đối tượng `targeting` trong đối tượng `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"] } } } ``` Các tùy chọn nhắm mục tiêu khả dụng được liệt kê trong các file JSON sau: ## Làm mới cấp phép (Authorization Refresh) LinkedIn phải được cấp phép lại *mỗi năm* qua trang Social Accounts. ## Giới hạn ký tự Vui lòng xem [Giới hạn ký tự LinkedIn](/help-center/technical-support/character_limits#linkedin-character-limits) để biết thêm thông tin. ## Vô hiệu hóa chia sẻ (Disable Share) Bạn có thể vô hiệu hóa khả năng người dùng chia sẻ lại bài đăng LinkedIn bằng cách đặt trường `disableShare` thành `true` trong đối tượng `linkedInOptions`: ```json LinkedIn Disable Share theme={"system"} { "linkedInOptions": { "disableShare": true } } ``` ## Tài liệu Sử dụng API để đăng một tài liệu lên LinkedIn. Các định dạng file được hỗ trợ bao gồm: PPT, PPTX, DOC, DOCX, và PDF. Đảm bảo tài liệu có kích thước dưới 100MB và không vượt quá 300 trang. Dưới đây là mẫu code minh họa cách đăng một tài liệu PPTX với tiêu đề: ```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"] } ``` URL phương tiện được cung cấp phải kết thúc bằng phần mở rộng tài liệu đã biết: ppt, pptx, doc, docx, hoặc pdf. ## Nhắc tên (Mention) trên LinkedIn Bạn có thể nhắc tên các tổ chức LinkedIn khác, tức là trang công ty, hoặc profile thành viên, tức là các trang profile cá nhân, trong bài đăng của bạn. Ayrshare cố gắng giải quyết @mention bằng cách tra cứu handle. Nếu @mention không được tìm thấy, @ sẽ được xóa khỏi bài đăng vì LinkedIn sẽ không chấp nhận các bài đăng có mention không được giải quyết. Không thể nhắc tên các profile LinkedIn cá nhân. Nếu bất kỳ mention nào trong bài đăng LinkedIn không thể được giải quyết (do cài đặt quyền riêng tư, hạn chế tài khoản, hoặc các hạn chế nền tảng khác), LinkedIn có thể không hiển thị tất cả các mention trong bài đăng đó dưới dạng liên kết có thể nhấp. Đây là hành vi nền tảng của LinkedIn chứ không phải vấn đề của API. Để tránh điều này, hãy đảm bảo tất cả người dùng và tổ chức được nhắc tên cho phép mention từ tổ chức của bạn hoặc cân nhắc đăng các mention riêng biệt để cô lập bất kỳ mention có vấn đề nào. Vui lòng xem lại [các quy tắc quan trọng](/testing/post-verification#mentions) về nhắc tên. ### Profile tổ chức Nhắc tên handle của một tổ chức LinkedIn khác bằng cách thêm `@handle` vào nội dung bài đăng. `@handle` là tên của công ty hoặc tổ chức. Bạn có thể nhắc tên trong bài đăng, bình luận, và trả lời bình luận. Ví dụ, ```json LinkedIn Mention theme={"system"} { "post": "The best social media API @ayrshare ever!", "platforms": ["linkedin"] } ``` ### Profile thành viên Nhắc tên một profile thành viên LinkedIn khác bằng cách thêm `@vanity_name` hoặc `@[John Smith]` vào nội dung bài đăng. 1. `@vanity_name` là vanity name của profile thành viên. Ví dụ trong URL profile của thành viên `https://www.linkedin.com/in/vanity_name/`, vanity name là `vanity_name`. 2. `@[John Smith]` là tên đầy đủ của người đó. Ví dụ nếu tên đầy đủ của người đó là `John Smith`, mention sẽ là `@[John Smith]`. Bạn có thể nhắc tên trong bài đăng, bình luận, và trả lời bình luận. ```json LinkedIn Mention theme={"system"} { "post": "The best social media API @[John Smith] and @ava_smith ever!", "platforms": ["linkedin"] } ``` Trong ví dụ trên, John Smith và Ava Smith sẽ được nhắc tên trong bài đăng — người đầu tiên bằng tên đầy đủ và người thứ hai bằng vanity name. **Lưu ý quan trọng:** 1. Bạn phải có một trang công ty LinkedIn được kết nối với tài khoản Ayrshare của bạn để nhắc tên các profile thành viên. Nếu bạn kết nối tài khoản LinkedIn cá nhân của mình, bạn sẽ không thể nhắc tên profile của người khác. 2. LinkedIn chỉ cho phép nhắc tên những người theo dõi tổ chức / trang công ty của bạn. ## Tiêu đề phương tiện Thêm tiêu đề hoặc chú thích phương tiện cho hình ảnh hoặc video LinkedIn. Sử dụng `titles` trong đối tượng `linkedInOptions`. ```json LinkedIn Media Titles theme={"system"} { "linkedInOptions": { "titles": ["This is an amazing video", "😃 here is the next one"] // Array of Alt Texts } } ``` Mỗi tiêu đề phải tương ứng với một hình ảnh hoặc video trong mảng `mediaUrls`. Tiêu đề sẽ được áp dụng cho từng hình ảnh hoặc video theo thứ tự. ## Bài đăng nhiều hình ảnh Bạn có thể đăng tối đa *9 URL hình ảnh* trong `mediaUrls` lên LinkedIn. ```json LinkedIn Multi Image Post theme={"system"} { "mediaUrls": ["https://url1", ..., "https://url9"] } ``` LinkedIn chưa hỗ trợ hình ảnh carousel cho các bài đăng tự nhiên. ## Post Visibility LinkedIn cho phép bạn kiểm soát visibility của các bài đăng. Bạn có thể đặt visibility thành public, chỉ connections, hoặc chỉ người dùng đã đăng nhập. Nếu không có visibility nào được chỉ định, bài đăng sẽ là "public" và hiển thị với tất cả người dùng LinkedIn. Sử dụng trường `visibility` trong đối tượng `linkedInOptions`: ```json LinkedIn Post Visibility theme={"system"} { "linkedInOptions": { "visibility": "public" // "public", "connections", or "loggedin" } } ``` ## Quyền xuất bản video Trên LinkedIn, chỉ những người dùng có quyền cụ thể mới có thể xuất bản video lên trang công ty: 1. Người dùng có quyền Admin. 2. Người dùng có quyền Direct Sponsored Content (DSC). Content Administrators không có khả năng xuất bản video lên trang công ty LinkedIn. ## Thumbnail video Đặt thumbnail LinkedIn cho một video. Gửi URL từ xa của một file PNG hoặc JPG có cùng kích thước với video và ít hơn 10 MB. URL phải kết thúc bằng .png hoặc .jpg. Sử dụng `thumbNail` trong đối tượng `linkedInOptions`. ```json LinkedIn Video Thumbnail theme={"system"} { "linkedInOptions": { "thumbNail": "https://octodex.github.com/images/Fintechtocat.png" } } ``` Vui lòng xem tại đây để biết thêm [ví dụ về việc sử dụng LinkedIn API](https://www.ayrshare.com/how-to-post-and-get-analytics-with-the-linkedin-api#linkedin-api-examples).