AdCP — Schemas

L0 ワイヤー層は、公開された JSON Schema でフレーム化された JSON-over-HTTP です。このページはスキーマを取得するためのリファレンスです — それらがどこに存在するか、バージョンをピン留めする方法、サプライチェーン来歴を検証する方法、リリース内のディレクトリ形状。スキーマ自体ではなく SDK を選んでいるなら、Choose your SDK を参照。

Schema access

AdCP スキーマは 2 つのソースから利用可能です:

Source	URL	Best For
Website	`https://adcontextprotocol.org/schemas/v3/`	ランタイムフェッチ、バージョンエイリアス
GitHub	`https://github.com/adcontextprotocol/adcp/tree/main/dist/schemas`	オフラインアクセス、CI/CD パイプライン

両ソースは同一のスキーマを含みます。GitHub リポジトリは、バンドルされたスキーマがコードベースに直接コミットされた、すべてのリリースされたバージョンを含みます。

One-shot protocol bundle

数百の個別スキーマファイルを同期するのは積み重なります。すべての AdCP リリースは、完全なプロトコル — スキーマ、コンプライアンスストーリーボード、OpenAPI レジストリ — を含む単一の gzip 圧縮された tarball も公開するため、クライアントはツリーをクロールする代わりに 1 つのアーティファクトを引けます。

Path	Contents	Notes
`https://adcontextprotocol.org/protocol/latest.tgz`	現在の開発バンドル	すべてのマージで変わる
`https://adcontextprotocol.org/protocol/{version}.tgz`	ピン留めされたリリースバンドル	公開されたら不変
`https://adcontextprotocol.org/protocol/{version}.tgz.sha256`	SHA-256 チェックサム	ダウンロード完全性の検証に使う
`https://adcontextprotocol.org/protocol/{version}.tgz.sig`	Sigstore 分離署名	発行者アイデンティティの検証に使う。リリースが `release.yml` ワークフロー経由でカットされたときのみ存在 — 帯域外の再公開では欠如。
`https://adcontextprotocol.org/protocol/{version}.tgz.crt`	Fulcio 発行の署名証明書	`cosign verify-blob` のため `.sig` とペア。リリースが `release.yml` ワークフロー経由でカットされたときのみ存在 — 帯域外の再公開では欠如。

すべての tarball は単一の adcp-{version}/ ディレクトリに展開されます（安全な展開、tarbomb なし）。内部:

adcp-{version}/
  README.md               # quickstart + links
  CHANGELOG.md            # release notes
  manifest.json           # version, generated_at, contents summary
  schemas/                # full JSON schema tree (same as /schemas/{version}/)
  compliance/             # protocols/, specialisms/, universal/, test-kits/, index.json
  openapi/registry.yaml   # OpenAPI description

展開前にチェックサムを検証:

curl -OL https://adcontextprotocol.org/protocol/3.1.0.tgz
curl -OL https://adcontextprotocol.org/protocol/3.1.0.tgz.sha256
shasum -a 256 -c 3.1.0.tgz.sha256
tar xzf 3.1.0.tgz
cd adcp-3.1.0

バージョンごとに一度引き、SHA でキャッシュすれば、リクエストを検証し、ストーリーボードを実行し、ドキュメントをオフラインでレンダリングするのに必要なすべてを持ちます。@adcp/sdk の sync-schemas コマンドはこれを内部で使います。利用可能な tarball は /protocol/ にもリストされています。

Verifying protocol bundle signatures

SHA-256 サイドカーは tarball と同じオリジンに存在するため、転送中の改ざんからのみ保護します。サプライチェーン保護 — バンドルが AdCP リリースワークフローから来たこと、ホストが侵害されても悪意あるものとすり替えられなかったことを証明 — のため、すべてのリリースされた {version}.tgz は Sigstore 分離署名とともに公開されます。署名は、keyless OIDC を使う GitHub Actions リリースワークフローによって生成されます: 漏洩する長寿命の AdCP 署名鍵はありません。証明書は署名をそれを発行したワークフローアイデンティティにバインドします。

# Pull the tarball and the two signature sidecars
curl -OL https://adcontextprotocol.org/protocol/3.1.0.tgz
curl -OL https://adcontextprotocol.org/protocol/3.1.0.tgz.sig
curl -OL https://adcontextprotocol.org/protocol/3.1.0.tgz.crt

# Verify (requires cosign 2.x — `brew install cosign`)
cosign verify-blob \
  --signature 3.1.0.tgz.sig \
  --certificate 3.1.0.tgz.crt \
  --certificate-identity-regexp '^https://github\.com/adcontextprotocol/adcp/\.github/workflows/release\.yml@refs/(heads|tags)/.*$' \
  --certificate-oidc-issuer 'https://token.actions.githubusercontent.com' \
  3.1.0.tgz

cosign verify-blob は、SHA が一致し TLS が有効でも、署名が AdCP リリースワークフロー以外のものによって作られた場合、非ゼロで終了します。プロトコルバンドルを取り込む任意のパイプラインで、強制ソースとしてこれを使ってください。@adcp/sdk、adcp-client-python、adcp-go SDK は、サイドカーが存在するときこの検証を自動的に実行します。 refs/(heads|tags)/.* ワイルドカードは意図的です — リリースは push トリガーのワークフロー実行中に署名するため、証明書サブジェクトはリリースブランチ（例: v3.0.1+ の refs/heads/3.0.x、v3.0.0 の refs/heads/main）を名指しします。信頼ゲートはコンシューマーの正規表現ではなく上流の release.yml の on.push.branches 許可リストです。リテラル許可リスト正規表現（(main|2\.6\.x) スタイル）は、新しい保守ブランチが追加されるたびに黙って壊れます — 完全な信頼モデルとリリースごとの証明書サブジェクトルックアップについてはプロトコル tarball の検証を参照。署名に先行する古いリリース、および帯域外で再公開されたバージョン（署名ワークフローをバイパス）は、チェックサムのみのままです — クライアントは欠けているサイドカーを検証失敗ではなく「チェックサムのみ」の信頼レベルとして扱うべきです。

Compliance storyboards

ストーリーボードは /compliance/{version}/ でスキーマと並んで存在します。それらは、AAO がエージェントのケイパビリティクレームを検証するために実行するテストシナリオを定義します。

Path	Purpose
`/compliance/{version}/universal/`	すべてのエージェントに必須（ケイパビリティディスカバリー、エラー処理、スキーマ検証）
`/compliance/{version}/protocols/{protocol}/`	プロトコル（`media-buy`、`creative`、`signals`、`governance`、`brand`、`sponsored-intelligence`）を主張するのに必要なベースライン
`/compliance/{version}/specialisms/{id}/`	任意の専門化クレーム（例: `sales-guaranteed`、`sales-broadcast-tv`）
`/compliance/{version}/index.json`	利用可能なプロトコル、専門分野、universal ストーリーボードを列挙

supported_protocols（プロトコルベースライン用）と specialisms（狭いケイパビリティクレーム用）を get_adcp_capabilities に宣言します — コンプライアンスランナーが一致するバンドルを実行して検証します。エージェントが主張できるすべてのプロトコルと専門分野については完全な Compliance Catalog を参照。

Common schemas

Schema	URL
Product	`https://adcontextprotocol.org/schemas/v3/core/product.json`
Media Buy	`https://adcontextprotocol.org/schemas/v3/core/media-buy.json`
Creative Format	`https://adcontextprotocol.org/schemas/v3/core/format.json`
Schema Registry	`https://adcontextprotocol.org/schemas/v3/index.json`

AI コーディングエージェント向け: MCP 統合ドキュメントについては、コーディングエージェントを https://docs.adcontextprotocol.org/mcp に向けてください。

Schema versioning

AdCP はセマンティックバージョニングを使います。ユースケースに正しいパスを選んでください:

Path	Example	Best For
正確なバージョン	`/schemas/3.0.0/`、`/compliance/3.0.0/`、`/protocol/3.0.0.tgz`	本番、SDK 生成
メジャーバージョン	`/schemas/v3/`、`/compliance/v3/`	開発、ドキュメント
マイナーバージョン	`/schemas/v3.0/`、`/compliance/v3.0/`	安定した開発（パッチ更新のみ）

同じバージョンセマンティクスが /schemas、/compliance、/protocol/{version}.tgz に適用されます — 1 つのリリースが 3 つすべてをカットします。

Production (recommended)

安定性のため正確なバージョンにピン留め:

const SCHEMA_VERSION = '3.0.0';
const schema = await fetch(
  `https://adcontextprotocol.org/schemas/${SCHEMA_VERSION}/core/product.json`
);

Development

後方互換の更新に追随するためメジャーバージョンエイリアスを使う:

const schema = await fetch(
  'https://adcontextprotocol.org/schemas/v3/core/product.json'
);

SDK type generation

# TypeScript
npx json-schema-to-typescript \
  https://adcontextprotocol.org/schemas/3.0.0/core/product.json \
  --output types/product.d.ts

# Python
datamodel-codegen \
  --url https://adcontextprotocol.org/schemas/3.0.0/core/product.json \
  --output models/product.py

Bundled schemas

$ref 解決をサポートしないツールには、すべての参照がインラインで解決されたバンドルスキーマを使います。バンドルスキーマは website と GitHub の両方から利用可能です:

Website access

https://adcontextprotocol.org/schemas/3.0.0/bundled/media-buy/create-media-buy-request.json

GitHub access

バンドルスキーマは dist/schemas/{VERSION}/bundled/ でリポジトリにコミットされています:

# Clone and access locally
git clone https://github.com/adcontextprotocol/adcp.git
ls adcp/dist/schemas/3.0.0/bundled/media-buy/

# Or fetch directly via GitHub raw
curl https://raw.githubusercontent.com/adcontextprotocol/adcp/main/dist/schemas/3.0.0/bundled/media-buy/get-products-request.json

Directory structure

dist/schemas/{VERSION}/
├── bundled/                      # Fully dereferenced schemas
│   ├── media-buy/                # Media buying tasks
│   ├── creative/                 # Creative tasks
│   ├── signals/                  # Signal protocol tasks
│   ├── property/                 # Property/governance tasks
│   ├── content-standards/        # Content standards tasks
│   ├── sponsored-intelligence/   # Sponsored intelligence tasks
│   ├── protocol/                 # Protocol tasks
│   └── core/                     # Core shared schemas and legacy task lifecycle schemas
├── core/                         # Modular schemas with $ref
├── trusted-match/                # Serve-time Context Match and Identity Match schemas
├── media-buy/
└── index.json                    # Schema registry

index.json がディレクトリ権威です。それはバンドルの published_version、安定性メタデータ、protocol_layers を宣言します: ネゴシエーション層（media-buy、creative、signals、account、governance、brand、sponsored-intelligence）と決定/配信層（trusted-match）。

Bundled schema categories

すべてのリクエスト/レスポンスタスクスキーマがバンドルされます:

Category	Tasks
`bundled/media-buy/`	get-products, create-media-buy, update-media-buy, list-creative-formats, sync-creatives, build-creative, list-creatives, get-media-buy-delivery, list-authorized-properties, provide-performance-feedback
`bundled/creative/`	list-creative-formats, preview-creative
`bundled/signals/`	get-signals, activate-signal
`bundled/property/`	create-property-list, get-property-list, list-property-lists, update-property-list, delete-property-list, validate-property-delivery
`bundled/content-standards/`	create-content-standards, get-content-standards, list-content-standards, update-content-standards, calibrate-content, validate-content-delivery, get-media-buy-artifacts
`bundled/sponsored-intelligence/`	si-get-offering, si-initiate-session, si-send-message, si-terminate-session
`bundled/protocol/`	get-adcp-capabilities, get-task-status, list-tasks
`bundled/core/`	tasks-get, tasks-list

利用可能なすべてのスキーマについてはスキーマレジストリを参照。

Version discovery

# Get the canonical stable schema bundle and registry URL.
curl https://adcontextprotocol.org/schemas/latest.json | jq '{version: .latest_stable, index}'

# Or read the full file-based discovery index.
curl https://adcontextprotocol.org/schemas/index.json | jq '.aliases'

# The versioned registry also carries the full semver of its bundle.
# (Note: `published_version` carries full semver including patch.
# It's distinct from the per-request/response wire `adcp_version`
# field defined in core/version-envelope.json, which uses
# release-precision — never send `published_version` on the wire.)
curl https://adcontextprotocol.org/schemas/v3/index.json | jq '.published_version'

正準バージョンをディレクトリ順や versions[0] から推論しないでください。プレリリースアーティファクトはピン留めされた履歴ビルドのため発見可能なままです。正準の安定選択には latest_stable または aliases マップを使ってください。バージョン履歴と移行ガイドについてはリリースノートを確認してください。

Registry API

AgenticAdvertising.org レジストリは、ブランド解決、プロパティ解決、エージェントディスカバリー、認可検証のためのパブリックな REST API を提供します。認証不要。

Registry API Reference

REST 経由でブランドを解決、エージェントを発見、認可を検証。

はじめに

AdCP で構築する

プロトコル

FAQ

トラストとセキュリティ

リファレンス

AAO

認定

Schemas

Schema access

One-shot protocol bundle

Verifying protocol bundle signatures

Compliance storyboards

Common schemas

Schema versioning

Production (recommended)

Development

SDK type generation

Bundled schemas

Website access

GitHub access

Directory structure

Bundled schema categories

Version discovery

Registry API

Registry API Reference

​Schema access

​One-shot protocol bundle

​Verifying protocol bundle signatures

​Compliance storyboards

​Common schemas

​Schema versioning

​Production (recommended)

​Development

​SDK type generation

​Bundled schemas

​Website access

​GitHub access

​Directory structure

​Bundled schema categories

​Version discovery

​Registry API

Registry API Reference

Schema access

One-shot protocol bundle

Verifying protocol bundle signatures

Compliance storyboards

Common schemas

Schema versioning

Production (recommended)

Development

SDK type generation

Bundled schemas

Website access

GitHub access

Directory structure

Bundled schema categories

Version discovery

Registry API