LinkedIn API - Ayrshare API Documentation

LinkedIn API 有以下要求和限制：

post 字段最多支持 3,000 个字符。
除非帖子中包含图片或视频，否则 LinkedIn 会自动在帖子中预览链接。在上面的示例中会显示图片。移除图片后，链接预览将会显示。如果链接预览无法获取，帖子仍将发布，并且 /post 响应中将返回 linkPreviewFailed: true 字段。
话题标签在 LinkedIn 中可点击。使用 # 符号指定 LinkedIn 话题标签。
如果发布视频，并且视频不是以已知的视频扩展名（如 mp4）结尾，请使用 isVideo 参数。详情请参见 /post 端点。
LinkedIn 视频处理需要几分钟完成。在尝试分享 URL 或获取视频分析之前，请稍等。
LinkedIn 每个 LinkedIn 账户每天限制 150 篇帖子。
不支持发布到 LinkedIn 群组。
LinkedIn 还支持发送无帖子文本的媒体。如果你不希望包含帖子文本，请发送空字符串 post: ""。
你可以链接公司主页或个人 LinkedIn 账户。
更多信息请参见 LinkedIn 媒体指南和 LinkedIn 授权。

你必须是”超级管理员”或”内容管理员”才能连接 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

用于无障碍和屏幕阅读器的图片替代文本。更多信息请参见 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 图片或视频的标题或媒体说明。每个标题按顺序对应一个媒体 URL。更多信息请参见 LinkedIn 媒体标题。

visibility

string

默认值:"public"

帖子的可见性。值：public、connections 或 loggedin。更多信息请参见 LinkedIn 帖子可见性。

替代文本

为 LinkedIn 图片添加 LinkedIn 替代文本（也称为 LinkedIn alt text）。LinkedIn 替代文本是一项无障碍功能，用于提供附加的用户信息并支持屏幕阅读器。LinkedIn 不支持视频或文档的 altText。在 linkedInOptions 对象中使用 altText。

LinkedIn Alt Text

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

每条替代文本必须对应 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 社交操作通知。
可以从 /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 进行查找来解析 @mention。如果找不到 @mention，@ 将从帖子中移除，因为 LinkedIn 不接受包含无法解析的提及的帖子。无法提及个人 LinkedIn 配置文件。

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

请查看提及功能的重要规则。

组织资料

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

你必须将 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 中最多向 LinkedIn 发布 9 个图片 URL。

LinkedIn Multi Image Post

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

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

帖子可见性

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

public：帖子将对所有 LinkedIn 用户可见。适用于公司主页和个人 LinkedIn 连接账户。如果未指定可见性，则为默认值。
connections：帖子将对所有者（用户配置文件）的 1 度网络可见。仅适用于个人 LinkedIn 连接账户。
loggedin：帖子仅对已登录的 LinkedIn 用户可见。适用于公司主页和个人 LinkedIn 连接账户。

在 linkedInOptions 对象中使用 visibility 字段：

LinkedIn Post Visibility

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

视频发布权限

在 LinkedIn 上，只有具有特定权限的用户可以将视频发布到公司主页：

具有管理员权限的用户。
具有 Direct Sponsored Content (DSC) 权限的用户。

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

组织资料

成员资料

媒体标题

多图片帖子

帖子可见性

视频发布权限

视频缩略图