> ## 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.

# Threads API

> Threads API を使った投稿オプション

<Info>
  Threads の公開処理は、Meta のサーバーサイドクローラー経由でお使いの URL からメディアを取得します。
  Ayrshare のエラーコード 379 が表示される場合（特に同一公開内で Instagram のエラー 440 または 138 と併発する場合）は、
  [Meta Media Crawler Blocked](/help-center/technical-support/meta_media_crawler_blocked) を参照してください。
</Info>

## Threads への投稿

Threads API を使って、リンクと画像を含む基本的な投稿を行う JSON：

```json Threads Post theme={"system"}
{
  "post": "The best Threads post ever #best #awesome https://www.threads.net", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["threads"]
}
```

Threads API には以下の要件と制限があります：

<ul class="custom-bullets">
  <li>
    Threads は、投稿に画像や動画が含まれていない限り、リンクを自動的にプレビュー表示します。上記の例では画像が表示されます。画像を削除するとリンクプレビューが表示されます。
  </li>

  <li>Threads プロファイルは、24 時間の移動期間内に API 経由で公開できる投稿数が 250 件に制限されています。</li>
  <li>Threads は 1 投稿につき 1 つのハッシュタグしか許可しません。</li>
  <li>@メンションされた Threads ユーザーは通知を受け取ります。</li>
  <li>投稿の最大文字数は 500 文字。</li>

  <li>
    複数画像/動画投稿はサポートされており、カルーセルとして送信されます。最大 20 の動画と画像を送信できます。
  </li>

  <li>
    Threads は API 経由の削除をサポートしていません。削除は Threads アプリから手動で行う必要があります。
  </li>

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

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

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

## Threads オプション

`threadsOptions` パラメーターを使って、投稿に追加のオプションを設定できます。

```json Threads Options theme={"system"}
{
  "threadsOptions": {
    "allowCountries": ["US", "CA"],
    "thread": true,
    "threadNumber": true,
    "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"] // used when sending as a thread of threads
  }
}
```

Threads オプションは、投稿を制御するために使用できる任意のフィールドです。

<ParamField body="allowCountries" type="array of strings">
  国コードを使って、投稿を特定の国に制限します。[国コード](/iso-codes/country) を使用してください。

  Meta がアカウントに対して地理制限を有効にしている場合のみ利用可能です。

  詳細は [Threads Geo Restrictions](/apis/post/social-networks/threads#geo-restrictions) を参照してください。
</ParamField>

<ParamField body="thread" type="boolean" default={false}>
  長い投稿を、オプションの番号付けとメディアを備えた連結されたスレッドシリーズに分割します。

  詳細は [Thread](/apis/post/social-networks/threads#thread) を参照してください。
</ParamField>

<ParamField body="threadNumber" type="boolean" default={false}>
  各スレッドの末尾に自動的に 1/n 形式の番号を追加します。

  `thread: true` が必要です。
</ParamField>

<ParamField body="mediaUrls" type="array of strings">
  スレッドオブスレッドにメディアオブジェクトを追加します。各スレッドに順番に 1 つのメディアオブジェクトが追加されます。

  特定のスレッドでメディアをスキップするには `null` を使用します。1 つのスレッドに複数のメディアを持たせるには、複数の URL を持つオブジェクトを使用します。

  詳細は [Thread Media](/apis/post/social-networks/threads#thread-media) を参照してください。
</ParamField>

## Threads 投稿に改行やリッチテキストを追加する

Threads の改行は、特殊な [改行文字](/apis/post/post#line-breaks) を使って投稿に追加できます。

太字や斜体などのリッチテキストは、いくつかの [html 要素](/apis/post/overview#rich-text-posts) を使って Threads 投稿に追加できます。

## 画像・動画のカルーセル

Threads に複数の画像や動画をカルーセルとして投稿できます。カルーセルには合計最大 20 個の画像や動画を使用可能です。追加の画像や動画を `mediaUrls` 配列に追加するだけで、カルーセルが自動的に作成されます。

```json theme={"system"}
"mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4" ...];  // Max 20 images or videos
```

動画 URL は mp4 のような既知の拡張子で終わる必要があります。

## 文字数制限

詳細については [Threads Character Limits](/help-center/technical-support/character_limits#threads-character-limits) を参照してください。

## 地理制限

`allowCountries` 配列を使って、投稿を特定の国に制限できます。

```json theme={"system"}
{
  "threadsOptions": {
    "allowCountries": ["US", "CA"]
  }
}
```

<ul class="custom-bullets">
  <li>
    `allowCountries`: 許可する国コードの配列。[国コード](/iso-codes/country) を参照してください。
  </li>
</ul>

<Warning>
  Threads の地理制限（ジオゲーティング）は、Meta がアカウントに対してこの機能を有効にしている場合のみ利用可能です。

  Meta は、アカウント認証、フォロワー数、コンテンツクリエイターステータスなどの要因に基づいて、どの Threads アカウントが地理制限の対象となるかを決定します。
  アカウントが対象の場合、新しい Threads 投稿を作成する際に投稿コンポーザー内に地理設定（地球アイコン）が表示されます。

  ユーザープロファイルが Threads の地理制限の対象かどうかは、[/user](/apis/user/profile-details) エンドポイントの `isEligibleForGeoRestrictions` プロパティを確認することで判定できます。
</Warning>

## Threads メンション

投稿テキストに @handle を追加することで、別の Threads ハンドルをメンションできます。例：

```json theme={"system"}
{
  "post": "The best social media API @Ayrshare ever!",
  "mediaUrls": ["https://images.com"],
  "platforms": ["threads"]
}
```

<Warning>
  @メンションされたユーザーには通知が届きます。メンションに関する [重要なルール](/testing/post-verification#mentions) を必ずご確認ください。
</Warning>

クォータに達している場合、エラーメッセージが返されます。

## スレッド

Threads のスレッド（スレッドストームとも呼ばれる）は、Threads 上で連結された一連の投稿で、単一の投稿の文字数制限を超える、より長いアイデアを共有できます。まとめて見ると 1 つの連続したナラティブとして表示されます。

### スレッドの投稿

Threads のスレッドは API 経由で投稿できます。スレッドは、Threads 上で関連付けられた返信投稿のセットに分割された投稿です。投稿を自動的に分割することも、投稿テキストの中で [スレッド分割](/apis/post/social-networks/threads#thread-breaks) を指定することもできます。

```json Threads Thread theme={"system"}
{
  "threadsOptions": {
    "thread": true,        // required for threadstorm
    "threadNumber": true,  // optional to add numbers to each thread
    "mediaUrls": ["https://site.com/image1.png", "https://site.com/image2.png", ...]  // optional one media object is added to a thread in order
  }
}
```

<ul class="custom-bullets">
  <li>
    `thread: true` — 改行に基づいて投稿テキストを自動的にスレッドに分割します。
  </li>

  <li>
    `threadNumber: true` — スレッドの末尾に 1/n 形式で自動的に番号を追加します。
    たとえば、5 つのスレッドのうち 2 番目のスレッドには 2/5 が追加されます。
  </li>

  <li>
    `mediaUrls: [array of urls]` — 各メディアオブジェクト（画像または動画）を順番にスレッドに追加します。
    各スレッドには順番に 1 つのメディアオブジェクトのみが追加されます。
  </li>
</ul>

#### スレッドメディア

##### メディアのスキップ

配列内で `null` を使うことで、あるスレッドのメディアをスキップできます。例：

`["https://site.com/image1.png", null, "https://site.com/image2.png"]`

これにより、1 番目の投稿に image1、2 番目の投稿には画像なし、3 番目の投稿に image2 が配置されます。

##### 複数のメディア

`mediaUrls` 配列内にメディア URL を持つオブジェクト `{}` を追加することで、スレッド内の 1 つの投稿に複数のメディアオブジェクトを追加できます。任意のユニークなオブジェクトキーが使用可能です。例：

```json Threads Thread with Multiple Media URLs theme={"system"}
{
  "threadsOptions": {
    "thread": true,
    "threadNumber": true,
    "mediaUrls": [
      "https://img.ayrshare.com/random/photo-1.jpg",
      {
        "1": "https://img.ayrshare.com/random/photo-2.jpg",
        "2": "https://img.ayrshare.com/random/photo-3.jpg"
      },
      "https://img.ayrshare.com/random/photo-4.jpg"
    ]
  }
}
```

この例では、1 番目の投稿に photo-1.jpg、2 番目の投稿に photo-2.jpg と photo-3.jpg、3 番目の投稿に photo-4.jpg が含まれます。

#### スレッド分割

Ayrshare は、投稿テキストを Threads に適した長さ（500 文字超）の投稿に自動的に分割します。スレッドを作成する際は、可能な限り 1 つの投稿の中に完結した文を保つことを優先します。文が収まらない場合は文と文の間で分割します。非常に長い文の場合は単語間で分割します。まれに単語が長すぎる場合、単語自体を分割します。

投稿テキストに `\n\n` を手動で追加することで、独自のスレッドを作成することを示すこともできます。投稿テキストに `\n\n` が含まれる場合、投稿を自動的にスレッドに分割することはしません。

例：

```json Example Threads Thread theme={"system"}
{
  "post": "This is post 1\n\nThis is post 2.",
  "platforms": ["threads"],
  "threadsOptions": {
    "thread": true
  }
}
```

は、スレッド内に 2 つの投稿を作成します。

段落を追加したいが、投稿に分割したくない場合は、`\u2063\n\u2063\n` を使用してください。

```json Threads Thread with Paragraphs theme={"system"}
{
  "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.",
  "platforms": ["threads"],
  "threadsOptions": {
    "thread": true
  }
}
```

は、投稿が 500 文字未満のため、2 つの段落を持つ 1 つの投稿になります。

### スレッドの削除

Threads は API 経由の削除をサポートしていません。削除は Threads アプリから手動で行う必要があります。