> ## 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 中可点击。使用 # 符号指定 LinkedIn 话题标签。</li>

  <li>
    如果发布视频，并且视频不是以已知的视频扩展名（如 mp4）结尾，请使用
    `isVideo` 参数。详情请参见 [/post 端点](/apis/post/post)。
  </li>

  <li>
    LinkedIn 视频处理需要几分钟完成。在尝试分享
    URL 或获取视频分析之前，请稍等。
  </li>

  <li>LinkedIn 每个 LinkedIn 账户每天限制 150 篇帖子。</li>
  <li>不支持发布到 LinkedIn 群组。</li>

  <li>
    LinkedIn 还支持发送无帖子文本的媒体。如果你不希望包含帖子文本，
    请发送空字符串 `post: ""`。
  </li>

  <li>你可以链接公司主页或个人 LinkedIn 账户。</li>

  <li>
    更多信息请参见 [LinkedIn 媒体指南](/media-guidelines/linkedin) 和 [LinkedIn
    授权](/dashboard/connect-social-accounts/linkedin)。
  </li>
</ul>

<Warning>
  你必须是"超级管理员"或"内容管理员"才能连接 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">
  用于无障碍和屏幕阅读器的图片替代文本。

  更多信息请参见 [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 图片或视频的标题或媒体说明。

  每个标题按顺序对应一个媒体 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 替代文本（也称为 LinkedIn alt text）。LinkedIn 替代文本是一项无障碍功能，用于提供附加的用户信息并支持屏幕阅读器。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
  }
}
```

每条替代文本必须对应 `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 国家/地区](https://logo.ayrshare.com/data/linkedin/countries.json)</li>
  <li>[LinkedIn 资历](https://logo.ayrshare.com/data/linkedin/seniorities.json)</li>
  <li>[LinkedIn 学位](https://logo.ayrshare.com/data/linkedin/degrees.json)</li>
  <li>[LinkedIn 研究领域](https://logo.ayrshare.com/data/linkedin/fieldsOfStudy.json)</li>
  <li>[LinkedIn 行业](https://logo.ayrshare.com/data/linkedin/industries.json)</li>
  <li>[LinkedIn 职能](https://logo.ayrshare.com/data/linkedin/jobFunctions.json)</li>

  <li>
    [LinkedIn 员工人数范围](https://logo.ayrshare.com/data/linkedin/staffCountRanges.json)
  </li>
</ul>

## 授权刷新

LinkedIn 必须\_每年\_通过 Social Accounts 页面重新授权。

<ul class="custom-bullets">
  <li>
    在授权到期前 15 天，将发送电子邮件和 webhook 社交操作通知。
  </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 进行查找来解析 @mention。
如果找不到 @mention，@ 将从帖子中移除，因为 LinkedIn 不接受包含无法解析的提及的帖子。
无法提及个人 LinkedIn 配置文件。

<Warning>
  如果 LinkedIn 帖子中的任何提及无法解析（由于隐私设置、
  账户限制或其他平台限制），LinkedIn 可能无法将该帖子中的所有
  提及呈现为可点击的链接。这是 LinkedIn 平台
  行为，不是 API 问题。为避免这种情况，请确保所有被提及的用户和
  组织允许来自你的组织的提及，或考虑将提及分开
  发布，以隔离任何有问题的提及。
</Warning>

请查看提及功能的[重要规则](/testing/post-verification#mentions)。

### 组织资料

通过在帖子文本中添加 `@handle` 来提及其他 LinkedIn 组织的用户名。`@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` 是成员资料的自定义名称。例如，在成员的资料 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 将在帖子中被提及 — 第一个使用全名，第二个使用自定义名称。

**重要说明：**

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` 中最多向 LinkedIn 发布 *9 个图片 URL*。

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

LinkedIn 尚不支持自然帖子的轮播图片。

## 帖子可见性

LinkedIn 允许你控制帖子的可见性。
你可以将可见性设置为 public（公开）、connections（仅关系人）或 loggedin（仅已登录用户）。
如果未指定可见性，帖子将为 "public"，对所有 LinkedIn 用户可见。

<ul class="custom-bullets">
  <li>
    `public`：帖子将对所有 LinkedIn 用户可见。适用于公司主页和
    个人 LinkedIn 连接账户。如果未指定可见性，则为默认值。
  </li>

  <li>
    `connections`：帖子将对所有者（用户配置文件）的 1 度网络可见。
    仅适用于个人 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. 具有管理员权限的用户。
2. 具有 Direct Sponsored Content (DSC) 权限的用户。

内容管理员没有将视频发布到 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)。