LinkedIn API - Ayrshare API Documentation

LinkedIn API 有以下需求與限制：

post 欄位最多可包含 3,000 個字元。
除非貼文中已包含圖片或影片，否則 LinkedIn 會自動預覽貼文中的連結。上述範例會顯示圖片，若移除圖片，就會改為顯示連結預覽。如果無法取得連結預覽，貼文仍會發布， /post 回應中會回傳 linkPreviewFailed: true 欄位。
LinkedIn 上的 hashtag 可點擊。使用 # 符號來指定 LinkedIn hashtag。
如果發布影片但副檔名不是常見的影片格式（例如 mp4），請使用 isVideo 參數。詳情請參閱 /post 端點。
LinkedIn 影片處理需要數分鐘才會完成。請稍待片刻後再嘗試分享 URL 或取得影片分析。
LinkedIn 每個帳號每日最多 150 則貼文。
不支援發布到 LinkedIn Groups。
LinkedIn 也支援發送不含貼文文字的媒體。如果你不想包含貼文文字，請傳送空字串 post: ""。
你可以連結公司頁面或個人 LinkedIn 帳號。
更多資訊請參閱 LinkedIn 媒體指南與 LinkedIn 授權。

你必須具備「Super Admin」或「Content Admin」權限，才能連結 LinkedIn 公司頁面。

發布到 LinkedIn

發布含連結與圖片的基本 LinkedIn 貼文的 JSON 範例：

LinkedIn Post

{
  "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"]
}

LinkedIn 選項

你可以透過 linkedInOptions 參數為貼文設定額外的選項。

LinkedIn Options

{
  "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 選項為可選欄位，用來控制貼文的呈現方式。

altText

array of strings

圖片的替代文字（alt text），為無障礙功能，可協助螢幕閱讀器讀取內容。更多資訊請參閱 LinkedIn 替代文字。

停用使用者轉分享 LinkedIn 貼文的功能。更多資訊請參閱 LinkedIn 停用分享。

targeting

object

依國家、產業、職稱等條件將你的自然貼文精準投放給特定族群。目標受眾中至少需要 300 名追蹤者。更多資訊請參閱 LinkedIn 受眾鎖定。

thumbNail

string

影片的縮圖。必須是 PNG 或 JPG 格式，尺寸與影片相同，並小於 10MB。URL 應以 .png 或 .jpg 結尾。更多資訊請參閱 LinkedIn 影片縮圖。

title

string

發布 PPT、PPTX、DOC、DOCX 或 PDF 檔案時的文件標題。最多 400 個字元。若未指定，會使用檔名。更多資訊請參閱 LinkedIn 文件。

titles

array of strings

LinkedIn 圖片或影片的標題或媒體說明。每個標題會依序對應 mediaUrls 中的媒體 URL。更多資訊請參閱 LinkedIn 媒體標題。

visibility

string

默认值:"public"

貼文的可見性。可用的值：public、connections 或 loggedin。更多資訊請參閱 LinkedIn 貼文可見性。

替代文字

為 LinkedIn 圖片加上替代文字（LinkedIn alt text）。LinkedIn alt text 是一項無障礙功能，可提供額外的使用者資訊，並協助螢幕閱讀器讀取內容。LinkedIn 不支援影片或文件的 altText。請在 linkedInOptions 物件中使用 altText。

LinkedIn Alt Text

{
  "linkedInOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts
  }
}

每個 alt text 必須對應到 mediaUrls 陣列中的一張圖片，並依序套用到每張圖片上。

受眾鎖定

LinkedIn 允許你將自然貼文投放給特定族群。可依國家、產業、職稱等條件進行鎖定。

LinkedIn 受眾鎖定需要目標受眾中至少 300 名追蹤者。例如，若你有 400 名追蹤者，只鎖定美國使用者，但其中只有 200 名追蹤者在美國，這樣的鎖定就會失敗，因為受眾範圍太小。

請在 linkedInOptions 物件中使用 targeting 物件：

LinkedIn Audience Targeting

{
  "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 頁面重新授權一次。

授權到期前 15 天，會發送電子郵件與 webhook social action 通知。
你可以從 /user 端點取得授權到期日與剩餘天數。
使用者會在到期前 30 天於社群帳號連結頁面看到警告訊息與重新整理按鈕。

字元限制

更多資訊請參閱 LinkedIn 字元限制。

停用分享

你可以透過在 linkedInOptions 物件中將 disableShare 欄位設為 true，停用使用者轉分享該 LinkedIn 貼文的功能：

LinkedIn Disable Share

{
  "linkedInOptions": {
    "disableShare": true
  }
}

文件

使用 API 可將文件發布到 LinkedIn。支援的檔案格式包含：PPT、PPTX、DOC、DOCX 與 PDF。請確保文件小於 100MB，且頁數不超過 300 頁。以下是一個發布 PPTX 文件並附上標題的程式碼範例：

LinkedIn Document Post

{
  "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 必須以下列已知的文件副檔名結尾：ppt、pptx、doc、docx 或 pdf。

LinkedIn 提及

你可以在貼文中提及其他 LinkedIn 組織（即公司頁面）或會員檔案（即個人資料頁）。 Ayrshare 會嘗試透過該 handle 進行查詢，來解析 @提及。若找不到該 @提及，會將 @ 從貼文中移除，因為 LinkedIn 不接受包含未解析提及的貼文。無法提及個人的 LinkedIn 檔案。

如果 LinkedIn 貼文中有任何提及無法解析（例如因為隱私設定、帳號限制或其他平台限制），LinkedIn 可能會導致該貼文中所有的提及都無法渲染為可點擊的連結。這是 LinkedIn 平台的行為，並非 API 問題。若要避免這種情況，請確保所有被提及的使用者與組織都允許來自你組織的提及，或考慮將提及拆到不同貼文中發布，以隔離有問題的提及。

請詳閱關於提及功能的重要規則。

組織檔案

在貼文文字中加入 @handle 即可提及其他 LinkedIn 組織 handle。@handle 是該公司或組織的名稱。你可以在貼文、留言以及回覆留言中使用提及。例如：

Ayrshare 的 LinkedIn 公司檔案為 https://www.linkedin.com/company/ayrshare，其 handle 為 @ayrshare。
Zara 的 LinkedIn 公司檔案為 https://www.linkedin.com/company/zara-sa/，其 handle 為 @zara-sa。

LinkedIn Mention

{
  "post": "The best social media API @ayrshare ever!",
  "platforms": ["linkedin"]
}

會員檔案

在貼文文字中加入 @vanity_name 或 @[John Smith] 即可提及其他 LinkedIn 會員檔案。

@vanity_name 是該會員檔案的 vanity name。例如會員檔案的 URL https://www.linkedin.com/in/vanity_name/ 中，vanity name 為 vanity_name。
@[John Smith] 是該人員的完整姓名。例如該人員完整姓名為 John Smith，其提及格式為 @[John Smith]。

你可以在貼文、留言以及回覆留言中使用提及。

LinkedIn Mention

{
  "post": "The best social media API @[John Smith] and @ava_smith ever!",
  "platforms": ["linkedin"]
}

在上述範例中，John Smith 與 Ava Smith 會在貼文中被提及 — 前者使用完整姓名，後者使用 vanity name。 重要注意事項：

你必須將 LinkedIn 公司頁面連結到你的 Ayrshare 帳號，才能提及會員檔案。若你只連結了個人 LinkedIn 帳號，將無法提及其他人的檔案。
LinkedIn 只允許提及追蹤你的組織 / 公司頁面的使用者。

媒體標題

為 LinkedIn 圖片或影片加上標題或媒體說明。請在 linkedInOptions 物件中使用 titles。

LinkedIn Media Titles

{
  "linkedInOptions": {
    "titles": ["This is an amazing video", "😃 here is the next one"] // Array of Alt Texts
  }
}

每個標題必須對應到 mediaUrls 陣列中的一張圖片或一部影片，並依序套用到每個媒體上。

多圖貼文

你最多可以在 mediaUrls 中傳入 9 個圖片 URL 發布到 LinkedIn。

LinkedIn Multi Image Post

{
  "mediaUrls": ["https://url1", ..., "https://url9"]
}

LinkedIn 目前尚未支援自然貼文的輪播圖片。

貼文可見性

LinkedIn 允許你控制貼文的可見性。你可以將可見性設為 public、僅限 connections，或僅限已登入使用者。若未指定可見性，貼文預設為 “public”，所有 LinkedIn 使用者都可以看到。

public：所有 LinkedIn 使用者皆可看到此貼文。公司頁面與個人 LinkedIn 連結帳號皆可使用。若未指定，預設即為此值。
connections：僅擁有者（User Profile）的一度人脈可看到此貼文。僅個人 LinkedIn 連結帳號可用。
loggedin：僅已登入的 LinkedIn 使用者可看到此貼文。公司頁面與個人 LinkedIn 連結帳號皆可使用。

請在 linkedInOptions 物件中使用 visibility 欄位：

LinkedIn Post Visibility

{
  "linkedInOptions": {
    "visibility": "public" // "public", "connections", or "loggedin"
  }
}

影片發布權限

在 LinkedIn 上，只有具備特定權限的使用者才能將影片發布到公司頁面：

具備 Admin 權限的使用者。
具備 Direct Sponsored Content（DSC）權限的使用者。

Content Administrators 無法將影片發布到 LinkedIn 公司頁面。

影片縮圖

為 LinkedIn 影片設定縮圖。請傳送 PNG 或 JPG 檔案的遠端 URL，尺寸須與影片相同且小於 10 MB。URL 應以 .png 或 .jpg 結尾。請在 linkedInOptions 物件中使用 thumbNail。

LinkedIn Video Thumbnail

{
  "linkedInOptions": {
    "thumbNail": "https://octodex.github.com/images/Fintechtocat.png"
  }
}

更多 LinkedIn API 使用範例。

​發布到 LinkedIn

​LinkedIn 選項

​替代文字

​受眾鎖定

​授權重新整理

​字元限制

​停用分享

​文件

​LinkedIn 提及

​組織檔案

​會員檔案

​媒體標題

​多圖貼文

​貼文可見性

​影片發布權限

​影片縮圖

發布到 LinkedIn

LinkedIn 選項

替代文字

受眾鎖定

授權重新整理

字元限制

停用分享

文件

LinkedIn 提及

組織檔案

會員檔案

媒體標題

多圖貼文

貼文可見性

影片發布權限

影片縮圖