> ## 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 有以下需求與限制：

<ul class="custom-bullets">
  <li>`post` 欄位最多可包含 3,000 個字元。</li>

  <li>
    除非貼文中已包含圖片或影片，否則 LinkedIn 會自動預覽貼文中的連結。上述範例會顯示
    圖片，若移除圖片，就會改為顯示連結預覽。如果無法取得連結預覽，貼文仍會發布，
    /post 回應中會回傳 `linkPreviewFailed: true` 欄位。
  </li>

  <li>LinkedIn 上的 hashtag 可點擊。使用 # 符號來指定 LinkedIn hashtag。</li>

  <li>
    如果發布影片但副檔名不是常見的影片格式（例如 mp4），請使用
    `isVideo` 參數。詳情請參閱 [/post 端點](/apis/post/post)。
  </li>

  <li>
    LinkedIn 影片處理需要數分鐘才會完成。請稍待片刻後再嘗試分享
    URL 或取得影片分析。
  </li>

  <li>LinkedIn 每個帳號每日最多 150 則貼文。</li>
  <li>不支援發布到 LinkedIn Groups。</li>

  <li>
    LinkedIn 也支援發送不含貼文文字的媒體。如果你不想包含貼文文字，
    請傳送空字串 `post: ""`。
  </li>

  <li>你可以連結公司頁面或個人 LinkedIn 帳號。</li>

  <li>
    更多資訊請參閱 [LinkedIn 媒體指南](/media-guidelines/linkedin) 與 [LinkedIn
    授權](/dashboard/connect-social-accounts/linkedin)。
  </li>
</ul>

<Warning>
  你必須具備「Super Admin」或「Content Admin」權限，才能連結 LinkedIn 公司頁面。{" "}
</Warning>

## 發布到 LinkedIn

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

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

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

<ParamField body="altText" type="array of strings">
  圖片的替代文字（alt text），為無障礙功能，可協助螢幕閱讀器讀取內容。

  更多資訊請參閱 [LinkedIn 替代文字](/apis/post/social-networks/linkedin#alternative-text)。
</ParamField>

<ParamField body="disableShare" type="boolean" default={false}>
  停用使用者轉分享 LinkedIn 貼文的功能。

  更多資訊請參閱 [LinkedIn 停用分享](/apis/post/social-networks/linkedin#disable-share)。
</ParamField>

<ParamField body="targeting" type="object">
  依國家、產業、職稱等條件將你的自然貼文精準投放給特定族群。

  目標受眾中至少需要 300 名追蹤者。

  更多資訊請參閱 [LinkedIn 受眾鎖定](/apis/post/social-networks/linkedin#audience-targeting)。
</ParamField>

<ParamField body="thumbNail" type="string">
  影片的縮圖。必須是 PNG 或 JPG 格式，尺寸與影片相同，並小於 10MB。URL 應以 .png 或 .jpg 結尾。

  更多資訊請參閱 [LinkedIn 影片縮圖](/apis/post/social-networks/linkedin#video-thumbnail)。
</ParamField>

<ParamField body="title" type="string">
  發布 PPT、PPTX、DOC、DOCX 或 PDF 檔案時的文件標題。最多 400 個字元。

  若未指定，會使用檔名。

  更多資訊請參閱 [LinkedIn 文件](/apis/post/social-networks/linkedin#documents)。
</ParamField>

<ParamField body="titles" type="array of strings">
  LinkedIn 圖片或影片的標題或媒體說明。

  每個標題會依序對應 `mediaUrls` 中的媒體 URL。

  更多資訊請參閱 [LinkedIn 媒體標題](/apis/post/social-networks/linkedin#media-titles)。
</ParamField>

<ParamField body="visibility" type="string" default="public">
  貼文的可見性。

  可用的值：`public`、`connections` 或 `loggedin`。

  更多資訊請參閱 [LinkedIn 貼文可見性](/apis/post/social-networks/linkedin#post-visibility)。
</ParamField>

## 替代文字

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

請在 `linkedInOptions` 物件中使用 `altText`。

```json LinkedIn Alt Text theme={"system"}
{
  "linkedInOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts
  }
}
```

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

## 受眾鎖定

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

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

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

```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 檔案中：

<ul class="custom-bullets">
  <li>[LinkedIn Countries](https://logo.ayrshare.com/data/linkedin/countries.json)</li>
  <li>[LinkedIn Seniorities](https://logo.ayrshare.com/data/linkedin/seniorities.json)</li>
  <li>[LinkedIn Degrees](https://logo.ayrshare.com/data/linkedin/degrees.json)</li>
  <li>[LinkedIn Fields of Study](https://logo.ayrshare.com/data/linkedin/fieldsOfStudy.json)</li>
  <li>[LinkedIn Industries](https://logo.ayrshare.com/data/linkedin/industries.json)</li>
  <li>[LinkedIn Job Functions](https://logo.ayrshare.com/data/linkedin/jobFunctions.json)</li>

  <li>
    [LinkedIn Staff Count Ranges](https://logo.ayrshare.com/data/linkedin/staffCountRanges.json)
  </li>
</ul>

## 授權重新整理

LinkedIn 必須「每年」透過 Social Accounts 頁面重新授權一次。

<ul class="custom-bullets">
  <li>
    授權到期前 15 天，會發送電子郵件與 webhook social action 通知。
  </li>

  <li>
    你可以從 [/user](/apis/user/overview) 端點取得授權到期日與
    剩餘天數。
  </li>

  <li>
    使用者會在到期前 30 天於社群帳號連結頁面看到警告訊息與重新整理按鈕。
  </li>
</ul>

## 字元限制

更多資訊請參閱 [LinkedIn 字元限制](/help-center/technical-support/character_limits#linkedin-character-limits)。

## 停用分享

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

```json LinkedIn Disable Share theme={"system"}
{
  "linkedInOptions": {
    "disableShare": true
  }
}
```

## 文件

使用 API 可將文件發布到 LinkedIn。支援的檔案格式包含：PPT、PPTX、DOC、DOCX 與 PDF。請確保文件小於 100MB，且頁數不超過 300 頁。

以下是一個發布 PPTX 文件並附上標題的程式碼範例：

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

## LinkedIn 提及

你可以在貼文中提及其他 LinkedIn 組織（即公司頁面）或會員檔案（即個人資料頁）。

Ayrshare 會嘗試透過該 handle 進行查詢，來解析 @提及。
若找不到該 @提及，會將 @ 從貼文中移除，因為 LinkedIn 不接受包含未解析提及的貼文。
無法提及個人的 LinkedIn 檔案。

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

請詳閱關於提及功能的[重要規則](/testing/post-verification#mentions)。

### 組織檔案

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

例如：

<ul class="custom-bullets">
  <li>
    Ayrshare 的 LinkedIn 公司檔案為
    [https://www.linkedin.com/company/ayrshare](https://www.linkedin.com/company/ayrshare)，其
    handle 為 *@ayrshare*。
  </li>

  <li>
    Zara 的 LinkedIn 公司檔案為
    [https://www.linkedin.com/company/zara-sa/](https://www.linkedin.com/company/zara-sa/)，其
    handle 為 *@zara-sa*。
  </li>
</ul>

```json LinkedIn Mention theme={"system"}
{
  "post": "The best social media API @ayrshare ever!",
  "platforms": ["linkedin"]
}
```

### 會員檔案

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

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 只允許提及追蹤你的組織 / 公司頁面的使用者。

## 媒體標題

為 LinkedIn 圖片或影片加上標題或媒體說明。

請在 `linkedInOptions` 物件中使用 `titles`。

```json LinkedIn Media Titles theme={"system"}
{
  "linkedInOptions": {
    "titles": ["This is an amazing video", "😃 here is the next one"] // Array of Alt Texts
  }
}
```

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

## 多圖貼文

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

```json LinkedIn Multi Image Post theme={"system"}
{
  "mediaUrls": ["https://url1", ..., "https://url9"]
}
```

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

## 貼文可見性

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

<ul class="custom-bullets">
  <li>
    `public`：所有 LinkedIn 使用者皆可看到此貼文。公司頁面與
    個人 LinkedIn 連結帳號皆可使用。若未指定，預設即為此值。
  </li>

  <li>
    `connections`：僅擁有者（User Profile）的一度人脈可看到此貼文。
    僅個人 LinkedIn 連結帳號可用。
  </li>

  <li>
    `loggedin`：僅已登入的 LinkedIn 使用者可看到此貼文。公司頁面與
    個人 LinkedIn 連結帳號皆可使用。
  </li>
</ul>

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

```json LinkedIn Post Visibility theme={"system"}
{
  "linkedInOptions": {
    "visibility": "public" // "public", "connections", or "loggedin"
  }
}
```

## 影片發布權限

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

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

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

## 影片縮圖

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

請在 `linkedInOptions` 物件中使用 `thumbNail`。

```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)。