> ## Documentation Index
> Fetch the complete documentation index at: https://adcp-docs-ja.pier1.co.jp/llms.txt
> Use this file to discover all available pages before exploring further.

# バージョンと互換性

> 公開されたすべての AdCP バージョン、そのステータス、EOL 日付。バージョンを選択またはアップグレードするならここから始める。

## 一目で

<Info>
  **今日の選択:** 新しい本番統合はワイヤーピン `"3.1"` で 3.1 を使うべきです。既存の 3.0 統合は移行中 `"3.0"` にピン留めしたままでかまいません。
</Info>

| Status            | Versions            | Wire pin | What it means                                                                                         |
| ----------------- | ------------------- | -------- | ----------------------------------------------------------------------------------------------------- |
| **Active**        | 3.1（現在の安定版: 3.1.0）  | `"3.1"`  | 現在の本番マイナーリリース。機能セットについては [What's New in AdCP 3.1](/docs/reference/whats-new-in-3-1) を参照。              |
| **Maintained**    | 3.0（現在の安定版: 3.0.19） | `"3.0"`  | 既存の本番統合のためにサポートされる前のマイナー。互換性とセキュリティのパッチを受け取る。                                                         |
| **Security-only** | 2.5.0, 2.5.1, 2.5.3 | `"2.5"`  | **2026 年 8 月 1 日（UTC）** までセキュリティパッチ。AAO ネットワーク本番には安全でない — [v2 sunset](/docs/reference/v2-sunset) を参照。 |
| **End of life**   | 2.0.0, 2.1.0        | —        | パッチなし。3.0 に移行。                                                                                        |
| **Planned**       | 3.2, 4.0            | —        | [計画されたリリース](/docs/reference/versioning#planned-releases) のターゲット。                                      |

**ワイヤー値はリリース精度のみです。** 安定版 3.1 ラインには `"3.1"` を、保守版 3.0 ラインには `"3.0"` を送ってください。`"3.0.19"` のようなパッチコンポーネントや `"3.1.0-rc.15"` のような完全な semver プレリリース値を送らないでください。`"3.1-rc.15"` のような歴史的なプレリリースピンは、それらのプレリリース値を明示的にアドバタイズするエージェントに対してのみ有効なままです。[パッチは交渉されない](/docs/reference/versioning#patches-are-not-negotiated) を参照。

*ステータス凡例: Active = 現在の安定世代。Maintained = サポートされる前のマイナー。Security-only = セキュリティ問題のみのパッチ、機能なし。End of life = パッチなし。Planned = 未リリース。*

## 公開されたすべてのバージョン

### 3.x — 現在の世代

| Version           | Released              | Notes                                    |
| ----------------- | --------------------- | ---------------------------------------- |
| 3.0.0             | 2026-04-22            | GA — 3.x サイクルの安定ベースライン。                  |
| 3.0.1〜3.0.10      | 2026-04-28〜2026-05-10 | パッチ。3.0.0 とワイヤー互換。                       |
| 3.0.11〜3.0.15     | 2026-05-11〜2026-05-31 | パッチ。3.0.0 とワイヤー互換。                       |
| 3.0.16〜**3.0.19** | 2026-06-14〜2026-06-17 | パッチ。**3.0.19 が最新の安定パッチ。** 3.0.0 とワイヤー互換。 |
| **3.1.0**         | 2026-06-18            | GA — 現在の本番マイナーリリース。ワイヤーピン `"3.1"` を使う。   |

パッチはワイヤーコントラクトを変えません。3.0.x 内のアップグレードは常に安全で、3.1 は 3.0 に対して加算的なままです。バージョンごとの詳細については [リリースノート](/docs/reference/release-notes)（キュレーションされた物語）と [チェンジログ](/docs/reference/changelog)（完全な技術履歴）を参照。

### プレリリース（置き換え済み）

| Version                | Released              | Notes                                                                                            |
| ---------------------- | --------------------- | ------------------------------------------------------------------------------------------------ |
| 3.1.0-rc.1〜3.1.0-rc.15 | 2026-05-29〜2026-06-16 | 3.1.0 GA によって置き換え。これらのアーティファクトはピン留めされたプレリリース採用者とリリースフォレンジックのために利用可能なまま。                          |
| 3.0.0-beta.1〜rc.2      | 2026-01-26〜2026-03-15 | 置き換え済み。                                                                                          |
| 3.0.0-rc.3             | 2026-04-01            | GA によって置き換え。rc.3 を採用した場合は [プレリリースアップグレードノート](/docs/reference/migration/prerelease-upgrades) を参照。 |

### 2.x — サンセット中

| Version | Released   | Notes                                           |
| ------- | ---------- | ----------------------------------------------- |
| 2.0.0   | 2025-10-15 | End of life。パッチなし。3.0 に移行。                      |
| 2.1.0   | 2025-10-19 | End of life。パッチなし。3.0 に移行。                      |
| 2.5.0   | 2025-11-22 | 2026 年 8 月 1 日（UTC）までセキュリティのみ。                  |
| 2.5.1   | 2025-12-24 | 2026 年 8 月 1 日（UTC）までセキュリティのみ。                  |
| 2.5.3   | 2026 年 1 月 | 2026 年 8 月 1 日（UTC）までセキュリティのみ。**最後の 2.x リリース。** |

2026 年 8 月 1 日（UTC）以降、2.x ライン全体が完全に非推奨になります。2.x スキーマ URL は既存の統合が黙って壊れないよう解決し続けますが、それらのスキーマはそれ以上の更新を受け取りません。移行パスについては [v2 Sunset](/docs/reference/v2-sunset) を参照。

## FAQ

### 「現在」とは何か？

新しい本番統合には **3.1.0** が現在です。統合を `"3.1"`（`"3.1.0"` ではなく）にピン留めしてください。既存の 3.0 統合は移行中 `"3.0"` にピン留めしたままでかまいません。[バージョンネゴシエーション](/docs/reference/versioning#version-negotiation) を参照。

### 2.2、2.3、2.4、2.6 はどうなったか？

2.x ラインはワーキンググループサイクル中にバージョン番号をスキップしました。一部は進行中のチェンジログエントリとして現れますが、決してリリースされませんでした — 変更は次の公開バージョンにロールフォワードされるか 3.0 に延期されました。公開された 5 つの 2.x リリースは 2.0.0、2.1.0、2.5.0、2.5.1、2.5.3 です。

### v2 エージェントをまだ登録できるか？

はい — v2 エージェントは AAO レジストリに登録できますが AAO Verified にはなれません。認証と verified-default ディスカバリーは v3.x を必要とします。[v2 Sunset → AAO レジストリを使う場合](/docs/reference/v2-sunset#if-you-use-the-aao-registry) を参照。

### 3.0 はどのくらいサポートされるか？

4.0 GA の後、少なくとも 12 か月。[バージョニング → 前のメジャーのサポートウィンドウ](/docs/reference/versioning#support-window-for-previous-major) を参照。

### 4.0 はどこか？

2027 年初頭を目標。3.x はサイクル中盤です — [計画されたリリース表](/docs/reference/versioning#planned-releases) を参照。

## バージョンの選択

| もしあなたが…               | 使う                                                                                                                                        |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| 今日新しい本番統合を構築している      | **3.1**。ワイヤーで `"3.1"` をピン留め。                                                                                                              |
| 既存の 3.0 統合を稼働している     | 移行中は **3.0** に留まるか、SDK と検証が準備できたら **3.1** に移る。                                                                                            |
| 2.5.x 統合を稼働している       | **2026 年 8 月 1 日（UTC）** より前に 3.0 に移行。[移行ガイド](/docs/reference/migration) から始める。                                                            |
| 2.0 または 2.1 統合を稼働している | 今すぐアップグレード — サポート外。                                                                                                                       |
| 3.1 後の未リリース機能を試している   | [リリースノート](/docs/reference/release-notes)、[バージョニングとガバナンス](/docs/reference/versioning)、[実験的ステータス](/docs/reference/experimental-status) を参照。 |

## 関連

* **[バージョニングとガバナンス](/docs/reference/versioning)** — リリースティア、スキーマ変更スコープ、ケイデンスポリシー
* **[v2 Sunset](/docs/reference/v2-sunset)** — 完全な v2 EOL タイムラインと移行パス
* **[v3 の新機能](/docs/reference/whats-new-in-v3)** — 3.0 が追加するものの機能ごとのサマリー
* **[What's New in AdCP 3.1](/docs/reference/whats-new-in-3-1)** — 最終的な 3.1 機能セットと採用者のアクション
* **[リリースノート](/docs/reference/release-notes)** — 各バージョンのキュレーションされた物語
* **[チェンジログ](/docs/reference/changelog)** — 完全な技術変更履歴
