メインコンテンツへスキップ
LinkedIn API には以下の要件と制限があります:
  • post フィールドは最大 3,000 文字を受け付けます。
  • 画像や動画が含まれていない場合、LinkedIn は自動的に投稿内のリンクをプレビューします。上記の例では画像が表示されます。画像を削除するとリンクプレビューが表示されます。リンクプレビューを取得できない場合でも、投稿は公開され、linkPreviewFailed: true フィールドが /post レスポンスに返されます。
  • LinkedIn ではハッシュタグがクリック可能です。LinkedIn ハッシュタグを指定するには # 記号を使用します。
  • 動画を公開する際、URL が mp4 などの既知の動画拡張子で終わらない場合は、isVideo パラメーターを使用してください。詳細は /post エンドポイント を参照してください。
  • LinkedIn の動画処理には数分かかります。共有 URL を試したり動画アナリティクスを取得したりする前に、少し待ってください。
  • LinkedIn は LinkedIn アカウントごとに 1 日 150 投稿までに制限しています。
  • LinkedIn グループへの投稿はサポートされていません。
  • LinkedIn は投稿テキストなしでメディアを送信することもサポートします。投稿テキストを含めない場合は、空の文字列 post: "" を送信します。
  • 会社ページまたは個人の LinkedIn アカウントのいずれかを連携できます。
  • 詳細は LinkedIn Media GuidelinesLinkedIn Authorization を参照してください。
LinkedIn 会社ページを連携するには “Super Admin” または “Content Admin” である必要があります。

LinkedIn への投稿

リンクと画像を含む基本的な LinkedIn 投稿の JSON:
LinkedIn Post

LinkedIn オプション

linkedInOptions パラメーターを使用して、投稿に追加のオプションを設定できます。
LinkedIn Options
LinkedIn オプションは、投稿を制御するために使用できるオプションフィールドです。
altText
array of strings
アクセシビリティとスクリーンリーダー用の画像の代替テキスト。詳細については LinkedIn Alternative Text を参照してください。
disableShare
boolean
デフォルト:false
ユーザーが LinkedIn 投稿を再共有する機能を無効にします。詳細については LinkedIn Disable Share を参照してください。
targeting
object
オーガニック投稿を国、業界、役職などによって特定のグループにターゲティングします。対象となるオーディエンスに少なくとも 300 人のフォロワーが必要です。詳細については LinkedIn Audience Targeting を参照してください。
thumbNail
string
動画のサムネイル。PNG または JPG、動画と同じ寸法、10MB 未満である必要があります。URL は .png または .jpg で終わる必要があります。詳細については LinkedIn Video Thumbnail を参照してください。
title
string
PPT、PPTX、DOC、DOCX、または PDF ファイルを投稿する際のドキュメントのタイトル。最大長: 400 文字。指定されていない場合は、ファイル名が使用されます。詳細については LinkedIn Documents を参照してください。
titles
array of strings
LinkedIn 画像または動画のタイトルまたはメディアキャプション。各タイトルは順番にメディア URL に対応します。詳細については LinkedIn Media Titles を参照してください。
visibility
string
デフォルト:"public"
投稿の公開範囲。値: public, connections, または loggedin詳細については LinkedIn Post Visibility を参照してください。

代替テキスト

LinkedIn の画像に LinkedIn 代替テキスト(alt text とも呼ばれる)を追加します。LinkedIn の alt text は、追加のユーザー情報とスクリーンリーダーに使用されるアクセシビリティ機能です。LinkedIn は動画やドキュメントの altText をサポートしていません。 linkedInOptions オブジェクトの altText を使用します。
LinkedIn Alt Text
各 alt text は mediaUrls 配列の画像に対応する必要があります。alt text は順番に各画像に適用されます。

オーディエンスターゲティング

LinkedIn では、オーガニック投稿を特定のユーザーグループにターゲティングできます。国、業界、役職などによってターゲティングできます。
LinkedIn ターゲティングでは、対象オーディエンスに 少なくとも 300 人のフォロワー が必要です。たとえば 400 人のフォロワーがいて米国のユーザーだけをターゲティングしても、フォロワーのうち米国にいるのが 200 人だけの場合、オーディエンスが少なすぎるためターゲティングは失敗します。
linkedInOptions オブジェクトの targeting オブジェクトを使用します:
LinkedIn Audience Targeting
利用可能なターゲティングオプションは、以下の JSON ファイルにリストされています:

認証の更新

LinkedIn は Social Accounts ページから 毎年 再認証する必要があります。
  • 認証の期限切れの 15 日前にメールと webhook のソーシャルアクション通知が送信されます。
  • 更新が必要な日付と残り日数は /user エンドポイントから取得できます。
  • ユーザーは、期限切れの 30 日前にソーシャルアカウント連携ページでアラートと更新ボタンを見ることができます。

文字数制限

詳細については LinkedIn Character Limits を参照してください。

共有無効化

linkedInOptions オブジェクトの disableShare フィールドを true に設定することで、ユーザーが LinkedIn 投稿を再共有する機能を無効にできます:
LinkedIn Disable Share

ドキュメント

API を使用して LinkedIn にドキュメントを投稿します。サポートされているファイル形式: PPT、PPTX、DOC、DOCX、PDF。ドキュメントは 100MB 未満で、300 ページ以内である必要があります。 以下は、タイトル付きの PPTX ドキュメントを投稿する方法を示すコードサンプルです:
LinkedIn Document Post
提供されるメディア URL は、既知のドキュメント拡張子 (ppt、pptx、doc、docx、pdf) で終わる必要があります。

LinkedIn メンション

投稿内で他の LinkedIn 組織(会社ページなど)またはメンバープロフィール(個別のプロフィールページ)をメンションできます。 Ayrshare はハンドルをルックアップして @mention の解決を試みます。 @mention が見つからない場合、LinkedIn は未解決のメンションを含む投稿を受け付けないため、投稿から @ が削除されます。 個別の LinkedIn プロフィールはメンションできません。
LinkedIn 投稿内のメンションが解決できない場合(プライバシー設定、アカウント制限、その他のプラットフォーム制限のため)、LinkedIn はその投稿のすべてのメンションをクリック可能なリンクとしてレンダリングできない場合があります。これは LinkedIn のプラットフォーム動作であり、API の問題ではありません。これを回避するには、メンションされたすべてのユーザーと組織がお客様の組織からのメンションを許可していることを確認するか、問題のあるメンションを分離するためにメンションを個別に投稿することを検討してください。
メンションに関する 重要なルール をご確認ください。

組織プロフィール

投稿テキストに @handle を追加することで、別の LinkedIn 組織ハンドルをメンションします。@handle は会社または組織の名前です。 投稿、コメント、コメントへの返信でメンションできます。 たとえば:
LinkedIn Mention

メンバープロフィール

投稿テキストに @vanity_name または @[John Smith] を追加することで、別の LinkedIn メンバープロフィールをメンションします。
  1. @vanity_name はメンバープロフィールの vanity 名です。たとえば、メンバーのプロフィール URL https://www.linkedin.com/in/vanity_name/ では、vanity 名は vanity_name です。
  2. @[John Smith] は人のフルネームです。たとえば、人のフルネームが John Smith の場合、メンションは @[John Smith] になります。
投稿、コメント、コメントへの返信でメンションできます。
LinkedIn Mention
上記の例では、John Smith と Ava Smith が投稿でメンションされます。前者はフルネームを使用し、後者は vanity 名を使用しています。 重要な注意事項:
  1. メンバープロフィールをメンションするには、Ayrshare アカウントに LinkedIn 会社ページが接続されている必要があります。個人の LinkedIn アカウントを接続した場合、他の人のプロフィールをメンションすることはできません。
  2. LinkedIn では、あなたの組織/会社ページをフォローしている人のみメンションできます。

メディアタイトル

LinkedIn 画像または動画にタイトルまたはメディアキャプションを追加します。 linkedInOptions オブジェクトの titles を使用します。
LinkedIn Media Titles
各タイトルは mediaUrls 配列の画像または動画に対応する必要があります。タイトルは順番に各画像または動画に適用されます。

複数画像投稿

LinkedIn の mediaUrls には最大 9 個の画像 URL を投稿できます。
LinkedIn Multi Image Post
LinkedIn はオーガニック投稿でのカルーセル画像をまだサポートしていません。

投稿の公開範囲

LinkedIn では、投稿の公開範囲を制御できます。 公開範囲を public、connections のみ、または loggedin ユーザーのみに設定できます。 公開範囲が指定されていない場合、投稿は “public” となり、すべての LinkedIn ユーザーに表示されます。
  • public: 投稿はすべての LinkedIn ユーザーに表示されます。会社ページと個人の LinkedIn 連携アカウントの両方で利用可能。公開範囲が指定されていない場合のデフォルト。
  • connections: 投稿はオーナー(ユーザープロフィール)の 1 次ネットワークに表示されます。個人の LinkedIn 連携アカウントでのみ利用可能。
  • loggedin: 投稿はログインしている LinkedIn ユーザーにのみ表示されます。会社ページと個人の LinkedIn 連携アカウントの両方で利用可能。
linkedInOptions オブジェクトの visibility フィールドを使用します:
LinkedIn Post Visibility

動画公開の権限

LinkedIn では、特定の権限を持つユーザーのみが会社ページに動画を公開できます:
  1. Admin 権限を持つユーザー。
  2. Direct Sponsored Content (DSC) 権限を持つユーザー。
Content Administrator は LinkedIn 会社ページに動画を公開する機能を持っていません。

動画サムネイル

動画に LinkedIn サムネイルを設定します。動画と同じ寸法で 10 MB 未満の PNG または JPG ファイルのリモート URL を送信します。URL は .png または .jpg で終わる必要があります。 linkedInOptions オブジェクトの thumbNail を使用します。
LinkedIn Video Thumbnail
LinkedIn API 使用のより多くの例 はこちらを参照してください。