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

# スキーマ & SDK

> AdCP スキーマとクライアント SDK のクイックスタートリファレンス: インストール、スキーマ URL、バージョンディスカバリー、次のステップ。

このページは、AdCP で構築するための 2 つの基礎的なリソース — すべてのリクエストとレスポンスを定義する JSON スキーマと、それらのスキーマを型付きコードに変える SDK — への道案内をします。

## SDK

AdCP は TypeScript、Python、Go 向けの公式 SDK を提供します。各 SDK はプロトコルレイヤー（ワイヤーフォーマット、署名、認証、ライフサイクルセマンティクス）を吸収するため、あなたはビジネスロジックだけを書けばよいのです。

<CardGroup cols={3}>
  <Card title="TypeScript" icon="js" href="https://www.npmjs.com/package/@adcp/sdk">
    `npm install @adcp/sdk`
  </Card>

  <Card title="Python" icon="python" href="https://pypi.org/project/adcp/">
    `pip install adcp`
  </Card>

  <Card title="Go" icon="golang" href="https://github.com/adcontextprotocol/adcp-go">
    `go get github.com/adcontextprotocol/adcp-go`
  </Card>
</CardGroup>

完全なカバレッジマトリクス（各 SDK が現在提供するレイヤー）、バージョンピン留めのガイダンス、パッケージエクスポートの詳細は [Choose your SDK](/docs/building/by-layer/L4/choose-your-sdk) を参照してください。

SDK の背後にあるレイヤーモデル — L0 から L4 がそれぞれ何を含むか、そしてなぜ SDK が単純なプロトコルよりも AdCP で重要なのか — は、[SDK stack リファレンス](/docs/building/cross-cutting/sdk-stack) を参照してください。

## スキーマ URL

AdCP スキーマは、現在のメジャーバージョンエイリアスの下、`https://adcontextprotocol.org/schemas/` で公開されています:

| パターン        | 例                                                                                  | 用途                                |
| ----------- | ---------------------------------------------------------------------------------- | --------------------------------- |
| **現在のメジャー** | `https://adcontextprotocol.org/schemas/v3/media-buy/create-media-buy-request.json` | バリデーターを AdCP 3.x スキーマファミリーにピン留めする |

スキーマは、すべてのタスクのリクエストとレスポンス、共有 enum、ガバナンスオブジェクト、クリエイティブフォーマット、シグナル定義をカバーします。本番と CI では現在のメジャーバージョン URL を使用し、メジャーリリースをまたいでリンクが安定するようにします。

ワイヤーレベルの `adcp_protocol_version` がスキーマバンドルバージョンとどう関係するか、そしてなぜそれらが別物なのかは、[Versioning & governance](/docs/reference/versioning) を参照してください。

## adagents.json の認可

パブリッシャーは、エージェントエンドポイントと認可スコープを `adagents.json` で宣言します。スキーマは 6 つの認可タイプ — `property_ids`、`property_tags`、`inline_properties`、`publisher_properties`、`signal_ids`、`signal_tags` — をサポートし、それぞれがエージェントが行動を認可されるインベントリをスコープします。

認可タイプの完全なリファレンスと実例は、ガバナンスドキュメントの [Authorization Patterns](/docs/governance/property/adagents#authorization-patterns) を参照してください。

## 次のステップ

<CardGroup cols={2}>
  <Card title="Choose your SDK" icon="box" href="/docs/building/by-layer/L4/choose-your-sdk">
    各言語のカバレッジマトリクス、インストールコマンド、バージョンピン留め。
  </Card>

  <Card title="Build an agent" icon="hammer" href="/docs/building/by-layer/L4/build-an-agent">
    セラーエージェント構築のためのスキルファイルとステップバイステップガイド。
  </Card>

  <Card title="Build a caller" icon="phone" href="/docs/building/by-layer/L4/build-a-caller">
    ケイパビリティの発見とレスポンス処理のためのバイヤー側リファレンス。
  </Card>

  <Card title="Validate your agent" icon="check" href="/docs/building/verification/validate-your-agent">
    コンプライアンススイートを実行して実装を検証します。
  </Card>
</CardGroup>