> ## 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 は自動的に投稿内のリンクをプレビューします。上記の例では画像が表示されます。画像を削除するとリンクプレビューが表示されます。リンクプレビューを取得できない場合でも、投稿は公開され、`linkPreviewFailed: true` フィールドが /post レスポンスに返されます。
  </li>

  <li>LinkedIn ではハッシュタグがクリック可能です。LinkedIn ハッシュタグを指定するには # 記号を使用します。</li>

  <li>
    動画を公開する際、URL が mp4 などの既知の動画拡張子で終わらない場合は、`isVideo` パラメーターを使用してください。詳細は [/post エンドポイント](/apis/post/post) を参照してください。
  </li>

  <li>
    LinkedIn の動画処理には数分かかります。共有 URL を試したり動画アナリティクスを取得したりする前に、少し待ってください。
  </li>

  <li>LinkedIn は LinkedIn アカウントごとに 1 日 150 投稿までに制限しています。</li>
  <li>LinkedIn グループへの投稿はサポートされていません。</li>

  <li>
    LinkedIn は投稿テキストなしでメディアを送信することもサポートします。投稿テキストを含めない場合は、空の文字列 `post: ""` を送信します。
  </li>

  <li>会社ページまたは個人の LinkedIn アカウントのいずれかを連携できます。</li>

  <li>
    詳細は [LinkedIn Media Guidelines](/media-guidelines/linkedin) と [LinkedIn Authorization](/dashboard/connect-social-accounts/linkedin) を参照してください。
  </li>
</ul>

<Warning>
  LinkedIn 会社ページを連携するには "Super Admin" または "Content Admin" である必要があります。{" "}
</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 Alternative Text](/apis/post/social-networks/linkedin#alternative-text) を参照してください。
</ParamField>

<ParamField body="disableShare" type="boolean" default={false}>
  ユーザーが LinkedIn 投稿を再共有する機能を無効にします。

  詳細については [LinkedIn Disable Share](/apis/post/social-networks/linkedin#disable-share) を参照してください。
</ParamField>

<ParamField body="targeting" type="object">
  オーガニック投稿を国、業界、役職などによって特定のグループにターゲティングします。

  対象となるオーディエンスに少なくとも 300 人のフォロワーが必要です。

  詳細については [LinkedIn Audience Targeting](/apis/post/social-networks/linkedin#audience-targeting) を参照してください。
</ParamField>

<ParamField body="thumbNail" type="string">
  動画のサムネイル。PNG または JPG、動画と同じ寸法、10MB 未満である必要があります。URL は .png または .jpg で終わる必要があります。

  詳細については [LinkedIn Video Thumbnail](/apis/post/social-networks/linkedin#video-thumbnail) を参照してください。
</ParamField>

<ParamField body="title" type="string">
  PPT、PPTX、DOC、DOCX、または PDF ファイルを投稿する際のドキュメントのタイトル。最大長: 400 文字。

  指定されていない場合は、ファイル名が使用されます。

  詳細については [LinkedIn Documents](/apis/post/social-networks/linkedin#documents) を参照してください。
</ParamField>

<ParamField body="titles" type="array of strings">
  LinkedIn 画像または動画のタイトルまたはメディアキャプション。

  各タイトルは順番にメディア URL に対応します。

  詳細については [LinkedIn Media Titles](/apis/post/social-networks/linkedin#media-titles) を参照してください。
</ParamField>

<ParamField body="visibility" type="string" default="public">
  投稿の公開範囲。

  値: `public`, `connections`, または `loggedin`。

  詳細については [LinkedIn Post Visibility](/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` 配列の画像に対応する必要があります。alt text は順番に各画像に適用されます。

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

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 のソーシャルアクション通知が送信されます。
  </li>

  <li>
    更新が必要な日付と残り日数は [/user](/apis/user/overview) エンドポイントから取得できます。
  </li>

  <li>
    ユーザーは、期限切れの 30 日前にソーシャルアカウント連携ページでアラートと更新ボタンを見ることができます。
  </li>
</ul>

## 文字数制限

詳細については [LinkedIn Character Limits](/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 はハンドルをルックアップして @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) で、使用するハンドルは *@ayrshare* です。
  </li>

  <li>
    Zara の LinkedIn 会社プロフィールは [https://www.linkedin.com/company/zara-sa/](https://www.linkedin.com/company/zara-sa/) で、使用するハンドルは *@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 名です。たとえば、メンバーのプロフィール URL `https://www.linkedin.com/in/vanity_name/` では、vanity 名は `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 名を使用しています。

**重要な注意事項:**

1. メンバープロフィールをメンションするには、Ayrshare アカウントに LinkedIn 会社ページが接続されている必要があります。個人の 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` 配列の画像または動画に対応する必要があります。タイトルは順番に各画像または動画に適用されます。

## 複数画像投稿

LinkedIn の `mediaUrls` には最大 *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. Admin 権限を持つユーザー。
2. Direct Sponsored Content (DSC) 権限を持つユーザー。

Content Administrator は LinkedIn 会社ページに動画を公開する機能を持っていません。

## 動画サムネイル

動画に LinkedIn サムネイルを設定します。動画と同じ寸法で 10 MB 未満の PNG または JPG ファイルのリモート URL を送信します。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) はこちらを参照してください。
