Chuyển đến nội dung chính
LinkedIn API có các yêu cầu và hạn chế sau:
  • Trường post chấp nhận tối đa 3.000 ký tự.
  • LinkedIn sẽ tự động xem trước liên kết trong bài đăng trừ khi có hình ảnh hoặc video đi kèm. Trong ví dụ trên, hình ảnh sẽ hiển thị. Việc bỏ hình ảnh sẽ khiến bản xem trước liên kết hiển thị. Nếu bản xem trước liên kết không thể lấy được, bài đăng vẫn sẽ được xuất bản và một trường linkPreviewFailed: true sẽ được trả về trong phản hồi /post.
  • Hashtag có thể nhấp được trên LinkedIn. Dùng ký hiệu # để chỉ định một hashtag LinkedIn.
  • Nếu xuất bản một video và không kết thúc bằng phần mở rộng video đã biết như mp4, vui lòng sử dụng tham số isVideo. Xem endpoint /post để biết chi tiết.
  • Việc xử lý video LinkedIn mất vài phút để hoàn thành. Vui lòng đợi trước khi thử URL chia sẻ hoặc lấy phân tích video.
  • LinkedIn giới hạn 150 bài đăng mỗi ngày cho mỗi tài khoản LinkedIn.
  • Đăng bài lên LinkedIn Groups không được hỗ trợ.
  • LinkedIn cũng hỗ trợ gửi phương tiện mà không có nội dung bài đăng. Nếu bạn không muốn bao gồm nội dung bài đăng, hãy gửi một chuỗi rỗng post: "".
  • Bạn có thể liên kết trang công ty hoặc tài khoản LinkedIn cá nhân.
  • Xem LinkedIn Media GuidelinesLinkedIn Authorization để biết thêm thông tin.
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:
LinkedIn Post

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.
LinkedIn Options
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.
altText
array of strings
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 để biết thêm thông tin.
disableShare
boolean
mặc định:false
Vô hiệu hóa khả năng người dùng chia sẻ lại bài đăng LinkedIn.Xem LinkedIn Disable Share để biết thêm thông tin.
targeting
object
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 để biết thêm thông tin.
thumbNail
string
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 để biết thêm thông tin.
title
string
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 để biết thêm thông tin.
titles
array of strings
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 để biết thêm thông tin.
visibility
string
mặc định:"public"
Visibility của bài đăng.Các giá trị: public, connections, hoặc loggedin.Xem 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.
LinkedIn Alt Text
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:
LinkedIn Audience Targeting
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.
  • Một email và thông báo webhook social action sẽ được gửi trước 15 ngày kể từ ngày hết hạn cấp phép.
  • Ngày yêu cầu làm mới và số ngày còn lại có thể được lấy từ endpoint /user.
  • Người dùng sẽ thấy trên trang liên kết tài khoản mạng xã hội của họ một cảnh báo và nút làm mới 30 ngày trước khi hết hạn.

Giới hạn ký tự

Vui lòng xem Giới hạn ký tự LinkedIn để 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:
LinkedIn Disable Share

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 đề:
LinkedIn Document Post
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 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ụ,
LinkedIn Mention

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.
LinkedIn Mention
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.
LinkedIn Media Titles
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.
LinkedIn Multi Image Post
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.
  • public: Bài đăng sẽ hiển thị với tất cả người dùng LinkedIn. Khả dụng cho cả trang công ty và các tài khoản LinkedIn cá nhân được kết nối. Mặc định nếu không có visibility nào được chỉ định.
  • connections: Bài đăng sẽ hiển thị với mạng lưới cấp độ 1 của chủ sở hữu (user profile). Chỉ khả dụng cho các tài khoản LinkedIn cá nhân được kết nối.
  • loggedin: Bài đăng sẽ hiển thị chỉ với người dùng LinkedIn đã đăng nhập. Khả dụng cho cả trang công ty và các tài khoản LinkedIn cá nhân được kết nối.
Sử dụng trường visibility trong đối tượng linkedInOptions:
LinkedIn Post Visibility

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.
LinkedIn Video Thumbnail
Vui lòng xem tại đây để biết thêm ví dụ về việc sử dụng LinkedIn API.