AdCP

すべての AdCP プロトコルにわたるセラーのプロトコルサポートとケイパビリティを発見します。これは、セラーが何をサポートするかを理解するためにバイヤーが最初に行うべき呼び出しです。

なぜこの形状か。 ケイパビリティは約 14 のトップレベルドメインキー（プロトコルごとに 1 つ、加えてアイデンティティと署名インフラ）に整理され、機能フラグは各ドメインの features/execution/その他のサブ名前空間の下にネストされます。私たちはフラットなケイパビリティリストを拒否しました — それはすべての実装者に無制限のサーフェスをスキャンさせ、関連するフラグが隣り合うことから来る発見性を取り除きます。新しいケイパビリティフラグは、新しいトップレベルキーではなく既存のドメインの下に属します。宣言はアドバタイズメントではなくコミットメントです（コンプライアンスランナーがそれらをプローブします）。→ 提案する前にケイパビリティエクスプローラーがツリーをたどります。→ 設計原則: ケイパビリティはコミットメント。

応答時間: 約 2 秒（設定ルックアップ）目的:

AdCP ディスカバリー - このエージェントは AdCP をサポートするか？どのバージョン？
プロトコルサポート - どのプロトコル（media_buy、signals、governance、sponsored_intelligence、creative、brand）？
認証モデル - このセラーはエージェントを直接信頼するか、各オペレーターが独立して認証しなければならないか？
詳細なケイパビリティ - 機能、実行統合、ジオターゲティング、ポートフォリオ

呼び出し元ごとの認可はここでレポートされません。 get_adcp_capabilities はセラーのサーフェス — 任意の認可された呼び出し元に対してそれができることすべて — を返します。特定のアカウントであなたが何を許可されているか（あなたのアイデンティティに対してどのタスクが呼び出し可能か、どのリクエストフィールドが変更可能か、attestation_verifier のような名前付きスコープ）を発見するには、sync_accounts と list_accounts レスポンスのアカウントごとのエントリの authorization オブジェクトを読みます。完全な形状とセマンティクスについては Caller authorization を参照。

リクエストスキーマ: /schemas/v3/protocol/get-adcp-capabilities-request.json レスポンススキーマ: /schemas/v3/protocol/get-adcp-capabilities-response.json

Tool-Based Discovery

AdCP はネイティブの MCP/A2A ツールディスカバリーを使います。エージェントのツールリストに get_adcp_capabilities が存在することが AdCP サポートを示します。

Discovery Flow:
Browse agent's tool list (MCP) or skills (A2A)
See 'get_adcp_capabilities' tool → Agent supports AdCP
Call get_adcp_capabilities → Get version, protocols, features, capabilities
Proceed based on returned capabilities

このアプローチ:

標準の MCP/A2A メカニズムを使う（カスタム拡張なし）
常に現在のケイパビリティを返す（古いメタデータではない）
すべてのケイパビリティ情報の単一の真実の源泉

:::note エージェントカード拡張（adcp-extension.json）は v3 で削除されました。代わりにツールベースのディスカバリーを使ってください。 :::

Version Negotiation

セラーはレスポンスの adcp.major_versions でサポートするメジャーバージョンを宣言します。バイヤーはリクエストの adcp_major_version で使用するバージョンを宣言します。

Version Negotiation Flow:
Buyer calls get_adcp_capabilities with adcp_major_version: 2
Seller checks 2 against its major_versions: [2, 3]
Version is supported → seller returns capabilities for v2
Buyer includes adcp_major_version: 2 on all subsequent requests

adcp_major_version はすべての AdCP リクエストスキーマの任意フィールドです。バイヤーは、マルチバージョンセラーと対話するときにすべてのリクエストに含めるべきです（SHOULD）。 セラーの動作:

adcp_major_version が提供されサポートされている → そのバージョンのスキーマで応答
adcp_major_version が提供されたがサポートされていない → VERSION_UNSUPPORTED を返す（バイヤーは adcp_major_version なしで呼び出してサポートバージョンを発見すべき）
adcp_major_version が省略された → 最高のサポートバージョンを想定

なぜマイナーではなくメジャーバージョンか？ セムバーポリシーはメジャーバージョン内での後方互換性を保証します。3.1 のセラーはネゴシエーションなしに 3.0 のバイヤーに提供できます。ケイパビリティモデルが機能レベルの差異を扱います — バイヤーは互換性を判断するために、バージョン番号ではなく特定のケイパビリティ（ターゲティングシステム、機能、拡張）を確認します。

Request Parameters

Field	Type	Description
`adcp_major_version`	integer	任意。バイヤーのペイロードが準拠する AdCP メジャーバージョン。提供された場合、セラーは自身の `major_versions` に対して検証し、範囲外の場合 `VERSION_UNSUPPORTED` を返す。省略された場合、セラーはサポートする最高のメジャーバージョンを想定する。
`protocols`	string[]	任意。特定のプロトコル（`media_buy`、`signals`、`governance`、`sponsored_intelligence`、`creative`、`brand`）にフィルタリング。省略された場合、すべてのサポートプロトコルを返す。

Response Structure

コア AdCP プロトコル情報:

Field	Type	Description
`major_versions`	integer[]	必須。サポートする AdCP メジャーバージョン（例: `[3]`）
`idempotency`	object	必須。冪等性セマンティクス。idempotency を参照。

idempotency

このセラーが idempotency_key リプレイ保護を尊重するかを宣言します。3.1 以降、idempotency_key はすべての AdCP タスクリクエスト（読み取りも変更も同様）で必須です（読み取りの段階的強制: 3.1 では SHOULD-reject、3.2 では MUST-reject。security.mdx § Idempotency を参照）。request_signing.supported パターンを反映 — ウィンドウの詳細から切り離された単一の肯定的宣言。クライアントはデフォルトを想定してはなりません（MUST NOT）。このブロックのないセラーは非準拠で、すべての呼び出しモードにわたってリトライに敏感な操作に対して安全でないものとして扱うべきです。

Field	Type	Description
`supported`	boolean	必須。セラーがリプレイを重複排除するか。`false` のとき、`idempotency_key` の送信は no-op です — セラーは `IDEMPOTENCY_CONFLICT` や `IDEMPOTENCY_EXPIRED` を返さず、素朴なリトライは二重処理します。バイヤーは支出コミット操作をリトライする前に自然キーチェック（例: `get_media_buys` に加え `context.internal_campaign_id` などのリクエストコンテキストや `context.buyer_ref` などのパッケージコンテキスト）を使わなければなりません（MUST）。
`replay_ttl_seconds`	integer	`supported: true` のとき必須。セラーがキーの正準レスポンスを保持する期間。最小 `3600`（1h）、推奨 `86400`（24h）、最大 `604800`（7d）。

{
  "adcp": {
    "major_versions": [3],
    "idempotency": { "supported": true, "replay_ttl_seconds": 86400 }
  }
}

リプレイ重複排除をサポートしないセラーは明示的に宣言します。

{
  "adcp": {
    "major_versions": [3],
    "idempotency": { "supported": false }
  }
}

宣言の検証。 idempotency.supported: true は、バイヤーが支出コミット操作を安全にリトライできるようにする信頼を担うクレームです。侵害されたまたはバグのあるセラーは、キーを黙って無視しながら true をアドバタイズし、リトライでバイヤーの二重支出を引き起こす可能性があります。バイヤーと適合性ランナーは、意図的なペイロード変異リプレイで宣言をプローブすべきです（SHOULD）: 同じ idempotency_key だが異なる正準ペイロードで 2 つのリクエストを送信する — 準拠セラーは 2 番目で IDEMPOTENCY_CONFLICT を返さなければなりません（MUST）。supported: true を宣言するセラーは、宣言が検証済みと見なされる前にベースラインコンプライアンスストーリーボードの一部としてこのプローブに合格しなければなりません（MUST）。

supported_protocols

このエージェントがサポートする AdCP プロトコル。これは単一のケイパビリティ軸です — 各値は (a) エージェントが実装するツールを宣言し、かつ (b) エージェントを /compliance/{version}/protocols/{protocol}/ のベースラインコンプライアンスストーリーボードの合格にコミットします。ランナーは JSON snake_case → URL kebab-case をマッピングします（media_buy → /compliance/.../protocols/media-buy/）。

{
  "supported_protocols": ["media_buy", "creative"]
}

有効な値: media_buy、creative、signals、governance、brand、sponsored_intelligence。各プロトコルのスコープについては Compliance Catalog を参照。コンプライアンステストコントローラーのサポートは、プロトコル値としてではなく、別個の compliance_testing ケイパビリティブロック（下記）で宣言されます。

specialisms

任意の専門化クレーム。各エントリは /compliance/{version}/specialisms/{id}/ の狭いストーリーボードに対応します。すべての専門分野は supported_protocols の 1 つのプロトコルにロールアップします — sales-guaranteed を主張するには media_buy が必要です。ランナーは親プロトコルが欠けている専門分野を拒否します。

{
  "specialisms": ["sales-guaranteed", "creative-template"]
}

すべての専門分野については完全な Compliance Catalog を、権威あるリストについては enum スキーマを参照。

Capability slot gaps

definePlatform などの SDK ヘルパーは、プラットフォーム実装をより狭いケイパビリティスロットに投影できます。それらのスロットをコミットメントとして扱ってください: エージェントが対応するタスクパスをエンドツーエンドで実行できるときのみスロットを宣言します。ストーリーボードやローカルテストベクターがエージェントが宣言しないスロットをターゲットにする場合、期待される適合性結果は失敗ではなく not_applicable です。ランナー側の強制が adcp-client#2244 で到着するまで、カスタムまたはプレリリーススイートを実行する実装者は、宣言されたスロットスコープ外のベクターに明示的なスキップゲートを追加すべきです。欠けているスロットを、それを宣言してプレースホルダーレスポンスを返すことで回避しないでください。それは正直なカバレッジギャップを失敗したケイパビリティクレームに変えます。

account

アカウントと認証のケイパビリティ。すべてのセラーはこのセクションを宣言すべきです — バイヤーは sync_accounts、list_accounts、または任意の認証済みタスクを呼び出す前にこれを読みます。シンプルなパブリッシャーでも、課金関係とサンドボックステストを扱うためにアカウント管理が必要です。

Field	Type	Description
`supported_billing`	string[]	必須。このセラーがサポートする課金モデル: `operator`、`agent`。バイヤーはすべての `sync_accounts` エントリでこれらの値の 1 つを `billing` として渡さなければならない。
`require_operator_auth`	boolean	デフォルト: `false`。誰が認証しなければならないかを宣言する。OAuth が使われるか、`list_accounts` が公開されるか、どの `sync_accounts` モードがサポートされるかを、それ自体では宣言しない。`true` のとき、各オペレーターは独立して認証し、アカウントスコープの呼び出しはセラー割り当ての `account_id` 値を使う（セラーまたは上流プラットフォームが正準アカウント名前空間を所有するため）。認証情報が複数のアカウントにアクセスしうる場合、セラーは `list_accounts` を公開しなければならず（MUST）、バイヤーは最初のアカウントスコープリクエストの前に明示的な `account_id` を解決しなければならない（MUST）。認証情報が正確に 1 つのアカウントにバインドされている場合、セラーはそのシングルトンを返す `list_accounts` を公開すべきである（SHOULD）。`false` のとき、エージェントは信頼され、バイヤーは `sync_accounts` でアカウントを宣言し、後続の呼び出しは自然キー（`brand` + `operator`）を渡す。
`authorization_endpoint`	string	オペレーター認証用の OAuth URL。セラーがオペレーター認証に OAuth をサポートするときに存在。`require_operator_auth: true` のとき関連。存在しない場合、オペレーターは帯域外（セラーポータル、API キー）で認証情報を取得する。
`required_for_products`	boolean	デフォルト: `false`。`true` のとき、バイヤーは `get_products` を呼び出す前にアカウントを確立しなければならない。`false` のとき、バイヤーはアカウントなしでプロダクトを参照できる。
`account_financials`	boolean	デフォルト: `false`。`true` のとき、セラーは支出、クレジット、請求ステータスをクエリする `get_account_financials` をサポート。operator 課金のアカウントにのみ適用可能。
`sandbox`	boolean	デフォルト: `false`。本番セールスエージェントに強く推奨。`true` のとき、セラーはテスト用のサンドボックスアカウントをサポート。サンドボックスモードを参照。

Auth models

バイヤー宣言アカウント（require_operator_auth: false）— セラーはエージェントのアイデンティティクレームを信頼します。エージェントは自身の bearer トークンで一度認証し、次に sync_accounts を呼び出して代表するブランドとオペレーターを宣言します。セラーはエージェントのクレームに基づいてアカウントをプロビジョニングし、任意で brand.json に対してオペレーターを検証します。後続のすべての呼び出しはエージェントの単一の認証情報を使い、自然キー（brand + operator）を渡します。 アカウント ID 名前空間（require_operator_auth: true）— 各オペレーターはセラーと直接認証しなければなりません。エージェントはオペレーターごとに認証情報を取得し（authorization_endpoint を使う OAuth 経由、または帯域外）、オペレーターごとのセッションを開き、後続のリクエストでセラー割り当ての account_id 値を渡します。OAuth は認証情報の取得であり、アカウントタクソノミー軸ではありません。2 つの名前空間パターンが同じワイヤー参照を使います: 上流管理のセラーは list_accounts を公開し、アカウントスコープ呼び出しの前に明示的なアカウント解決を必須にします。list_accounts のないセラー定義の名前空間は帯域外でアカウント ID を提供します。サンドボックスについては、パスはアカウント名前空間に従います: アカウント ID 名前空間は list_accounts または帯域外セットアップで既存のテストアカウントを発見します。バイヤー宣言アカウントは sandbox: true の sync_accounts でサンドボックスを宣言します。完全なワークフローについてはアカウントとエージェントを、認証モデルと課金サポートの一般的な組み合わせについてはセラーパターンを参照。

media_buy

メディアバイプロトコルのケイパビリティ。media_buy が supported_protocols にある場合にのみ存在。media_buy を宣言するセラーは account（supported_billing 付き）と media_buy.portfolio も含めるべきです — バイヤーは課金の確立とインベントリカバレッジの理解の両方に必要です。コンプライアンステストがそれらの存在を検証します。 :::note 3.0 の破壊的変更次のフィールドはケイパビリティレスポンスから削除されました:

media_buy.reporting — レポートは media_buy によって暗示されます。代わりにプロダクトレベルの reporting_capabilities を使ってください。
features.content_standards — media_buy.content_standards オブジェクトに置き換え。オブジェクトの存在がサポートを示します。
features.audience_targeting — media_buy.audience_targeting オブジェクトに置き換え。
features.conversion_tracking — media_buy.conversion_tracking オブジェクトに置き換え。
execution.targeting.device_platform、device_type — media_buy サポートによって暗示。
execution.targeting.audience_include、audience_exclude — audience_targeting オブジェクトの存在によって暗示。
execution.trusted_match.supported — オブジェクトの存在がサポートを示します。
brand.identity — supported_protocols の brand によって暗示。get_brand_identity は常に利用可能。 :::

reporting_delivery_methods

セラーのプロダクトポートフォリオ全体でどのプッシュベースの配信方法が利用可能かを宣言します。get_media_buy_delivery によるポーリングは、このフィールドに関係なくすべての media_buy セラーに必須のタスクです。

Method	Description	Configuration
`webhook`	セラーがバイヤー提供の URL にプッシュ	バイヤーがメディアバイごとに `reporting_webhook` を設定
`offline`	セラーがクラウドストレージバケットにバッチファイルをプッシュ	セラーがアカウントごとに `reporting_bucket` をプロビジョニング

存在しない場合、ポーリングのみが利用可能です。ケイデンスとメトリクスはプロダクトごとに reporting_capabilities で宣言されます。 offline が宣言される場合、どのクラウドストレージプロトコルがサポートされるか（s3、gcs、azure_blob）を宣言する offline_delivery_protocols も含めます。詳細はオフラインファイル配信を参照。

creative_approval_mode

クリエイティブが割り当てられ自動検証が通過した後の、セラーのテナント全体のクリエイティブ承認姿勢を宣言します。これは通知サーフェスや新しい承認ワークフローではありません。人間のレビューが配信適格性をまだブロックできるかをバイヤーとコンプライアンスランナーに伝えます。

Value	Description
`auto_approve`	クリエイティブが割り当てられ自動検証が通過した後、人間のレビューは配信適格性をブロックしない。
`require_human`	1 つ以上のプロダクト/アカウントが、クリエイティブが配信適格になる前に手動レビューを必要とする場合がある。プロダクトレベルのオーバーライドが存在するまで、テナント全体の最悪ケースの上限として扱う。

混合承認ポリシーを持つセラーは、アドバタイズされたエージェントで到達可能なすべてのプロダクト/アカウントが自動検証後の自動適格性をサポートしない限り、require_human を宣言すべきです（SHOULD）。フィールドが存在しない場合、承認動作はレガシー未指定です。ランナーは省略を肯定的な auto_approve クレームとして扱うべきではありません（SHOULD NOT）。

features

任意のメディアバイ機能。true と宣言された場合、セラーはその機能を使うリクエストを尊重しなければなりません（MUST）。

Feature	Description
`inline_creative_management`	`create_media_buy` と `update_media_buy` のパッケージペイロードでクリエイティブをインラインで受け入れる
`property_list_filtering`	`get_products` の `property_list` パラメーターを尊重する
`catalog_management`	カタログフィード管理のための `sync_catalogs` をサポート

content_standards

コンテンツ標準の実装詳細。このオブジェクトの存在は、セラーがサンプリングレートとカテゴリフィルタリングを含むコンテンツ標準設定をサポートすることを示します。

Field	Type	Description
`supports_local_evaluation`	boolean	セラーがローカル評価モデルを実行するか。`false` のとき、`local_verdict` は常に `unevaluated` になり、`get_media_buy_artifacts` の `failures_only` フィルターは有用でない。
`supported_channels`	string[]	セラーがコンテンツアーティファクトを提供できるチャネル。
`supports_webhook_delivery`	boolean	セラーが購入作成時に設定された `artifact_webhook` によるプッシュベースのアーティファクト配信をサポートするか。

Example:

{
  "content_standards": {
    "supports_local_evaluation": true,
    "supported_channels": ["display", "olv", "podcast"],
    "supports_webhook_delivery": true
  }
}

supports_local_evaluation が false の場合、get_media_buy_artifacts の failures_only フィルターは空の結果セットを返します — すべての判定が unevaluated になります。

execution

技術的な実行ケイパビリティ:

Field	Type	Description
`trusted_match`	object	TMP サポート。存在する場合、このセラーはリアルタイムのコンテキストおよび/またはアイデンティティマッチングをサポート。
`axe_integrations`	string[]	非推奨。このセラーが実行できるレガシー AXE URL。新しい統合には `trusted_match` を使う。
`creative_specs`	object	クリエイティブ仕様サポート（VAST バージョン、MRAID など）
`targeting`	object	ターゲティングケイパビリティ（ジオ粒度）

axe_integrations

axe_integrations は、このセラーが実行できる Agentic Ad Exchange（AXE）エンドポイント URL の配列です。AXE は AdCP キャンペーンのリアルタイム実行層です — バイヤーエージェントを標準化されたエクスチェンジ経由でプログラマティックインベントリに接続します。

creative_specs

Field	Type	Description
`vast_versions`	string[]	サポートする VAST バージョン（例: `["4.0", "4.1", "4.2"]`）
`mraid_versions`	string[]	サポートする MRAID バージョン
`vpaid`	boolean	VPAID サポート
`simid`	boolean	SIMID サポート

targeting

Field	Type	Description
`geo_countries`	boolean	ISO 3166-1 alpha-2 コードを使う国レベルのターゲティング
`geo_regions`	boolean	ISO 3166-2 コードを使う地域/州レベルのターゲティング（例: `US-NY`、`GB-SCT`）
`geo_metros`	object	システム固有のサポートを持つメトロエリアターゲティング
`geo_postal_areas`	object	国と精度のサポートを持つ郵便エリアターゲティング
`age_restriction`	object	`supported` フラグと `verification_methods` を持つ年齢制限ケイパビリティ
`language`	boolean	言語ターゲティング（ISO 639-1 コード）
`keyword_targets`	object	`supported_match_types` 配列（`broad`、`phrase`、`exact`）を持つキーワードターゲティング。
`negative_keywords`	object	`supported_match_types` 配列を持つ除外キーワードターゲティング。
`geo_proximity`	object	任意の座標からの近接ターゲティング（下記参照）

デバイスプラットフォームとデバイスタイプのターゲティングは media_buy サポートによって暗示されます。オーディエンスの include/exclude ターゲティングは audience_targeting ケイパビリティオブジェクトの存在によって暗示されます。地理的ターゲティングレベルをサポートするセラーは、そのレベルで包含と除外の両方をサポートすべきです（SHOULD）。片方向のみをサポートする場合、黙って無視するのではなく、サポートされないフィールドに対して検証エラーを返さなければなりません（MUST）。 geo_proximity はどの近接ターゲティング方法がサポートされるかを指定します:

Field	Type	Description
`radius`	boolean	シンプルな半径ターゲティング
`travel_time`	boolean	移動時間アイソクローンターゲティング
`geometry`	boolean	事前計算された GeoJSON ジオメトリ
`transport_modes`	string[]	アイソクローンでサポートされる交通手段: `driving`、`walking`、`cycling`、`public_transport`

geo_metros はどのメトロ分類システムがサポートされるかを指定します:

System	Description
`nielsen_dma`	Nielsen DMA コード（米国市場、例: NYC の `501`）
`uk_itl1`	UK ITL レベル 1 地域
`uk_itl2`	UK ITL レベル 2 地域
`eurostat_nuts2`	Eurostat NUTS レベル 2 地域（EU）

geo_postal_areas はどの国ローカルの郵便番号システムがサポートされるかを指定します。推奨される形状は ISO 3166-1 alpha-2 国でキー付けされ、各国がサポートするシステムをリストします:

{
  "us_zip": true,
  "us_zip_plus_four": true,
  "US": ["zip", "zip_plus_four"],
  "GB": ["outward", "full"],
  "CA": ["fsa", "full"],
  "ZA": ["postal_code"]
}

より具体的な登録済みローカルシステムのない国では通常の郵便番号文字列に postal_code を使います。3.x 移行中、セラーはエイリアスが存在する場合、ネイティブの国キーとともに us_zip などの同等の非推奨エイリアスを発するべきです（SHOULD）。

audience_targeting

オーディエンスターゲティングのケイパビリティ。このオブジェクトの存在は、セラーが sync_audiences とターゲティングオーバーレイの audience_include/audience_exclude を含むオーディエンスターゲティングをサポートすることを示します。

Field	Type	Required	Description
`supported_identifier_types`	string[]	必須	オーディエンスマッチングに受け入れられる PII 由来の識別子タイプ。値: `hashed_email`、`hashed_phone`。
`minimum_audience_size`	integer	必須	ターゲティングに必要な最小マッチオーディエンスサイズ。このしきい値未満のオーディエンスは `status: too_small` になる。
`supports_platform_customer_id`	boolean		`true` のとき、セラーはバイヤーの CRM/ロイヤルティ ID をマッチ可能な識別子として受け入れる。
`supported_uid_types`	string[]		オーディエンスマッチングに受け入れられるユニバーサル ID タイプ（MAID、RampID、UID2 など）。
`matching_latency_hours`	object		アップロード後の期待マッチングレイテンシー範囲（時間）。形状: `{ min: integer, max: integer }`。

conversion_tracking

セラーレベルのコンバージョントラッキングケイパビリティ。kind: "event" 最適化目標についてセラーがサポートするものを宣言します。

Field	Type	Description
`multi_source_event_dedup`	boolean	セラーが単一目標内の複数イベントソースにわたってイベントを重複排除できるか。
`supported_event_types`	string[]	このセラーが追跡できるイベントタイプ。省略された場合、すべての標準イベントタイプがサポート。
`supported_uid_types`	string[]	ユーザーマッチングに受け入れられるユニバーサル ID タイプ。
`supported_hashed_identifiers`	string[]	受け入れられるハッシュ化 PII タイプ（`hashed_email`、`hashed_phone`）。
`supported_action_sources`	string[]	このセラーがイベントを受け入れるアクションソース。
`attribution_windows`	object[]	利用可能なアトリビューションウィンドウ。

portfolio

インベントリポートフォリオ情報:

Field	Type	Description
`publisher_domains`	string[]	必須。このセラーが代表するパブリッシャードメイン
`primary_channels`	string[]	主要な広告チャネル
`primary_countries`	string[]	主要な国（ISO コード）
`description`	string	Markdown ポートフォリオ説明
`advertising_policies`	string	コンテンツポリシーと制限

signals

シグナルプロトコルのケイパビリティ。signals が supported_protocols にある場合にのみ存在。

Field	Type	Description
`data_provider_domains`	string[]	このシグナルエージェントが再販を認可されているデータプロバイダードメイン。
`discovery_modes`	string[]	エージェントが `get_signals` でサポートするディスカバリーモード。`"brief"`（`signal_spec` / `signal_refs` によるセマンティックディスカバリー）は暗黙的で常にサポート。呼び出し元が `signal_spec` / `signal_refs` / `signal_ids` を省略して完全な価格付きシグナルフィードを列挙できることをアドバタイズするには `"wholesale"` を宣言する。宣言がない場合は `["brief"]` として扱う。
`features.catalog_signals`	boolean	非推奨。 adagents.json `signals[]` のプロバイダー公開シグナル定義への構造化 `signal_ref` 参照のレガシーワイヤーフラグ。

catalog_signals は非推奨です。既存の 3.x エージェントは互換性のためこれを発し続けてもかまいませんが、新しいエージェントはこれを省略すべきで（SHOULD）、呼び出し元は signal_ref を使う前にこれを必須としてはなりません（MUST NOT）。

creative

クリエイティブプロトコルのケイパビリティ。creative が supported_protocols にある場合にのみ存在。

Field	Type	Description
`supports_compliance`	boolean	`true` のとき、このクリエイティブエージェントはコンプライアンス要件（`required_disclosures`、`prohibited_claims`）を持つブリーフを処理でき、開示がターゲットフォーマットで満たせることを検証する。
`supports_transformers`	boolean	`true` のとき、このクリエイティブエージェントはアカウントスコープのトランスフォーマー（ボイス、モデル、スタイル）を提供する。`list_transformers` で発見し、`build_creative` で `transformer_id` により選択。
`supports_refinement`	boolean	`true` のとき、このクリエイティブエージェントは生成した `build_variant` リーフを保持し、`build_creative` の `refine_from_build_variant_id` から再ビルドできる。
`refinable_retention_seconds`	integer	`supports_refinement` が `true` のとき、生成された `build_variant_id` が `refine_from_build_variant_id` 経由で絞り込み可能なままの保証最小ウィンドウ（下限であり上限ではない）。
`multiplicity`	object	バイヤーが `max_creatives`/`max_variants` を送る前のファンアウト判別子。`supports_catalog_fanout` + `max_creatives_limit`、`supports_variants` + `max_variants_limit`、`variant_dimensions[]`。
`supports_spend_controls`	boolean	`true` のとき、`build_creative` は呼び出しごとの `max_spend` 上限を尊重し、`mode: "estimate"` ドライランをサポート。`bills_through_adcp: true` の場合にのみ意味を持つ。
`bills_through_adcp`	boolean	`true` のとき、このクリエイティブエージェントは AdCP レートカードサーフェスを通じて課金する。`false` または存在しない場合、エージェントは帯域外で課金する。

governance

ガバナンスプロトコルのケイパビリティ。governance が supported_protocols にある場合にのみ存在。ガバナンスエージェントは 4 つのドメインにわたってケイパビリティを宣言します: プロパティ評価、クリエイティブ評価、コンテンツ標準検証、ポリシーレジストリ統合。

property_features

このガバナンスエージェントが評価できるプロパティ機能の配列。プロパティガバナンスを参照。

Field	Type	Description
`feature_id`	string	必須。一意識別子（例: `mfa_score`、`coppa_certified`）。Policy Registry エントリにマップされる機能には `registry:{policy_id}` プレフィックスを使う。
`type`	string	必須。データタイプ: `binary`、`quantitative`、`categorical`。
`range`	object	quantitative 用: `{ min, max }`
`categories`	string[]	categorical 用: 有効な値
`description`	string	人間可読な説明
`methodology_url`	string	方法論ドキュメントへの URL

creative_features

このガバナンスエージェントが評価できるクリエイティブ機能の配列。property_features と同じフィールドスキーマ。クリエイティブガバナンスを参照。

content_standards

コンテンツ標準検証のケイパビリティ。コンテンツ標準を参照。

Field	Type	Description
`supported`	boolean	このエージェントがコンテンツ標準検証エージェントとして機能できるか
`calibration_formats`	string[]	このエージェントが評価できるアーティファクトアセットタイプ（例: `text`、`image`、`video`、`audio`）

policy_registry

ポリシーレジストリ統合のケイパビリティ。Policy Registry を参照。

Field	Type	Description
`supported`	boolean	このエージェントが AdCP ポリシーレジストリからポリシーを消費するか
`domains`	string[]	このエージェントがカバーするガバナンスドメイン（例: `campaign`、`property`、`creative`、`content_standards`）

ガバナンスエージェントレスポンスの例:

{
  "$schema": "/schemas/protocol/get-adcp-capabilities-response.json",
  "status": "completed",
  "adcp": {
    "major_versions": [3],
    "idempotency": { "supported": true, "replay_ttl_seconds": 86400 }
  },
  "supported_protocols": ["governance"],
  "governance": {
    "property_features": [
      { "feature_id": "mfa_score", "type": "quantitative", "range": { "min": 0, "max": 100 }, "description": "Made For Advertising detection (0=quality content, 100=likely MFA)", "methodology_url": "https://vendor.example.com/methodology/mfa" },
      { "feature_id": "coppa_certified", "type": "binary", "description": "COPPA compliance certification" },
      { "feature_id": "registry:uk_hfss", "type": "binary", "description": "UK HFSS advertising restrictions compliance" },
      { "feature_id": "carbon_score", "type": "quantitative", "range": { "min": 0, "max": 100 }, "description": "Carbon footprint sustainability score", "methodology_url": "https://vendor.example.com/methodology/carbon-score" }
    ],
    "creative_features": [
      { "feature_id": "registry:eu_ai_act_article_50", "type": "binary", "description": "EU AI Act Article 50 — AI-generated content disclosure" },
      { "feature_id": "registry:ca_sb_942", "type": "binary", "description": "California SB 942 — AI transparency compliance" },
      { "feature_id": "auto_redirect", "type": "binary", "description": "Detects auto-redirect behavior in creative code" },
      { "feature_id": "credential_harvest", "type": "binary", "description": "Detects credential harvesting patterns" }
    ],
    "content_standards": {
      "supported": true,
      "calibration_formats": ["text", "image", "video"]
    },
    "policy_registry": {
      "supported": true,
      "domains": ["campaign", "property", "creative", "content_standards"]
    }
  }
}

measurement

実験的な測定プロトコルのケイパビリティ。measurement が supported_protocols にある場合にのみ存在。それを実装するエージェントは experimental_features に measurement.core もリストしなければなりません。measurement プロトコルは現在、カタログ探索のための get_adcp_capabilities（このブロック）にスコープされています。 スコープ。 measurement を主張するエージェントは、広告配信、エクスポージャー、または効果についての 1 つ以上の定量的メトリクスを計算します（インプレッション検証、ビューアビリティ、IVT、アテンション、ブランドリフト、インクリメンタリティ、成果、排出 — ベンダーが metrics[] でサーフェスを定義）。メトリクス定義（このブロック）を返し、価格やカバレッジ（measurement_terms で購入ごとに交渉）やライブ値（vendor_metric_values で購入ごとに返す）は返しません。

metrics

この測定エージェントが計算するメトリクスの配列。

Field	Type	Description
`metric_id`	string	必須。ベンダースコープの識別子（`attention_units`、`gco2e_per_impression` など）。完全なアイデンティティはタプル `(vendor.domain, vendor.brand_id, metric_id)`。
`standard_reference`	string (URI)	このメトリクスが実装する公開標準を指す任意の URI。
`accreditations`	object[]	このメトリクスが持つサードパーティ認定の任意のリスト（MRC、ARF、JIC 機関など）。各エントリ: `accrediting_body`（必須）、任意の `certification_id`、`valid_until`、`evidence_url`。
`unit`	string	`vendor_metric_values.value` でレポートされる値の単位（`score`、`seconds`、`persons`、`gCO2e`、`lift_percent`、`USD` など）。
`description`	string	メトリクスが測定するものと方法論ノートの人間可読な説明。
`methodology_url`	string (URI)	ベンダーの完全な方法論ドキュメントへの URL。
`methodology_version`	string	方法論の任意のバージョン識別子。
`ext`	object	AdCP `ext` 慣例に従うベンダー拡張。

Response example

{
  "measurement": {
    "metrics": [
      {
        "metric_id": "attention_units",
        "standard_reference": "https://iabtechlab.com/standards/attention-measurement",
        "accreditations": [
          { "accrediting_body": "MRC", "certification_id": "MRC-ATT-2026-001", "valid_until": "2027-12-31", "evidence_url": "https://mediaratingcouncil.org/accreditations/attentionvendor" }
        ],
        "unit": "score",
        "description": "Eye-tracking-based attention score (0-100). Computed from a panel of 25K opted-in households.",
        "methodology_url": "https://attentionvendor.example/docs/attention-units",
        "methodology_version": "v2.1"
      },
      {
        "metric_id": "engagement_seconds",
        "unit": "seconds",
        "description": "Active dwell time in seconds, measured via in-content telemetry."
      }
    ]
  }
}

これはディスカバリーサーフェスであり、レートカードではありません。 カタログはバイヤーにベンダーが何を測定し、どの標準/認定が裏付けるかを伝えます。インプレッションごとの価格、最小測定可能インベントリ、アトリビューションウィンドウ、地理的カバレッジ、データ鮮度 SLA は、このカタログではなく、create_media_buy のセラーの measurement_terms を通じて購入ごとに交渉されます。

compliance_testing

コンプライアンステストのケイパビリティ。このブロックの存在は、エージェントが comply_test_controller による決定的テストをサポートすることを宣言します。エージェントがコンプライアンステストをサポートしない場合はブロックを省略します。 本番デプロイはこのブロックを含めてはなりません（MUST NOT）。 comply_test_controller はデプロイレベルでサンドボックス専用です。ディスパッチがゲートされていても、本番エンドポイントでケイパビリティをアドバタイズすることは非準拠です。

Field	Type	Description
`scenarios`	string[]	このエージェントがサポートするコンプライアンステストシナリオ。値は `list_scenarios` を除き、エージェントが実装するすべての正準コントローラーシナリオを含むべき（SHOULD）。現在の正準値には `force_creative_status`、`force_account_status`、`force_media_buy_status`、`seed_product`、`seed_measurement_catalog` などが含まれる。ランナーはシナリオ名をオープン文字列として扱わなければならない（MUST）。

:::note コンプライアンステストはデプロイレベルでサンドボックス専用です — 本番デプロイはこのブロックをアドバタイズしたり、任意のサーフェスで comply_test_controller を公開したりしてはなりません（MUST NOT）。 :::

webhook_signing

セラーの webhook 署名姿勢を宣言します。変更 webhook の発出をアドバタイズする任意のセラー — media_buy.reporting_delivery_methods に webhook を含む、media_buy.content_standards.supports_webhook_delivery: true、または wholesale_feed_webhooks.supported: true を含むがこれらに限らない — は、このブロックを supported: true で含めなければなりません（MUST）。webhook をまったく発出しないセラーはブロックを完全に省略してもかまいません（MAY）。

Field	Type	Description
`supported`	boolean	セラーがケイパビリティサーフェスの他の場所で変更 webhook の発出をアドバタイズする場合に必須。セラーがアウトバウンド webhook に署名する場合にのみ `true`。`false` はセラーが webhook を発出するが署名しないことを意味する。バイヤーはオンボーディングに失敗しなければならない（MUST）。
`profile`	string	`supported: true` のとき必須。プロファイルバージョン文字列。現在は `"adcp/webhook-signing/v1"`。
`algorithms`	string[]	`supported: true` のとき必須。 `["ed25519", "ecdsa-p256-sha256"]` のサブセット。
`legacy_hmac_fallback`	boolean	`supported: true` のとき必須。セラーがレガシー HMAC-SHA256 スキームをサポートする場合にのみ `true`。`false` が 3.x で推奨される姿勢 — HMAC スキームは AdCP 4.0 で削除される。

Example:

{
  "webhook_signing": {
    "supported": true,
    "profile": "adcp/webhook-signing/v1",
    "algorithms": ["ed25519", "ecdsa-p256-sha256"],
    "legacy_hmac_fallback": false
  }
}

webhook 署名ブロックは request_signing（インバウンド）と並行し、2 つのブロックがバイヤーとセラー間の 2 つの署名方向をカバーします。

extensions_supported

このエージェントがサポートする拡張名前空間の配列。バイヤーはこのエージェントからのレスポンスの ext.{namespace} フィールドに意味のあるデータを期待できます。

Field	Type	Description
`extensions_supported`	string[]	拡張名前空間（例: `["iab_tcf", "iab_gpp"]`）

拡張スキーマは AdCP 拡張レジストリに公開されています。 Example:

{
  "extensions_supported": ["iab_tcf", "iab_gpp", "acmecorp"]
}

experimental_features

このエージェントが実装する実験的 AdCP サーフェスの配列。サーフェスは、そのスキーマが x-status: experimental を運ぶとき実験的です — コアプロトコルの一部だがまだ凍結されておらず、6 週間の予告をもって 3.x リリース間で破壊される可能性があります。任意の実験的サーフェスを実装するセラーは、ここにその機能 id をリストしなければなりません（MUST）。

Field	Type	Description
`experimental_features`	string[]	実験的機能 id（例: `["brand.rights_lifecycle", "governance.campaign", "measurement.core", "trusted_match.core", "sponsored_intelligence.core"]`）

Example:

{
  "experimental_features": ["brand.rights_lifecycle", "measurement.core", "trusted_match.core"]
}

完全な安定性コントラクト、卒業基準、クライアントガイダンスについては実験的ステータスを参照。

wholesale_feed_versioning

get_products と get_signals の条件付きフェッチトークンケイパビリティ。ホールセールフィード webhook から独立: エージェントは変更ペイロードをプッシュせずに安価なバージョンプローブをサポートしてもよく（MAY）、修復のための再照合読み取りを依然として要求しながら変更ペイロードをプッシュしてもよい（MAY）。

Field	Type	Description
`supported`	boolean	必須。エージェントがレスポンスで `wholesale_feed_version` を返し、リクエストで `if_wholesale_feed_version` を尊重するか。
`pricing_version_separate`	boolean	エージェントが `pricing_version` を `wholesale_feed_version` から独立して追跡するか。
`cache_scope_account`	boolean	エージェントが `cache_scope: "account"` を返すことがあるか（すなわち、パブリックレートカードとは別のアカウント別オーバーレイを公開するか）。

Example:

{
  "wholesale_feed_versioning": {
    "supported": true,
    "pricing_version_separate": true,
    "cache_scope_account": true
  }
}

wholesale_feed_webhooks

エージェントごとのホールセールプロダクトフィードとホールセールシグナルフィードの webhook ケイパビリティ。セールスエージェント（プロダクト）とシグナルエージェント（シグナル）が宣言します。supported が true のとき、コンシューマーは product.*、signal.*、wholesale_feed.bulk_change イベントの sync_accounts.accounts[].notification_configs[] エントリを登録し、各 webhook で実際の変更ペイロードを受け取れます。 用語。 ここで「ホールセールフィード」は、get_products と get_signals が公開するエージェントの購入可能なホールセールプロダクトフィードとホールセールシグナルフィードを意味します。これは、キャンペーン実行のためにバイヤー提供のキャンペーン入力フィードをセラーアカウントにプッシュする sync_catalogs とは異なります。

Field	Type	Description
`supported`	boolean	必須。このエージェントがアカウントレベルの `sync_accounts.accounts[].notification_configs[]` を通じてホールセールフィード変更ペイロードをプッシュできるか。
`event_types`	string[]	このエージェントが発出できるイベントタイプ。セールスエージェントは `product.` イベントを発出。シグナルエージェントは `signal.` イベントを発出。

Example（セールス + シグナルエージェント）:

{
  "wholesale_feed_webhooks": {
    "supported": true,
    "event_types": [
      "product.created", "product.updated", "product.priced", "product.removed",
      "signal.created", "signal.updated", "signal.priced", "signal.removed",
      "wholesale_feed.bulk_change"
    ]
  }
}

The Capability Contract

ケイパビリティが宣言された場合、セラーはそれを尊重しなければなりません（MUST）。

media_buy.execution.targeting.geo_postal_areas.US が zip を含む → バイヤーは { country: "US", system: "zip", values: [...] } を送信でき、セラーはそれを尊重しなければならない
media_buy.execution.targeting.geo_metros.nielsen_dma: true → バイヤーは DMA コードを送信でき、セラーはそれを尊重しなければならない
media_buy.content_standards オブジェクトが存在 → セラーは提供時にコンテンツ標準を適用しなければならない
media_buy.audience_targeting オブジェクトが存在 → セラーは sync_audiences とオーディエンスターゲティングオーバーレイをサポートしなければならない
media_buy.conversion_tracking オブジェクトが存在 → セラーは sync_event_sources と log_event をサポートしなければならない

黙って無視しない。セラーがケイパビリティをサポートできない場合、false を宣言するか省略すべきです。

Common Scenarios

Basic Capability Discovery

import { AdcpClient } from '@adcp/sdk';

const client = new AdcpClient({ baseUrl: 'https://seller.example.com/mcp' });

// Get seller capabilities
const result = await client.getAdcpCapabilities({});

if (result.errors) {
  throw new Error(`Request failed: ${result.errors[0].message}`);
}

// Check protocol support
console.log(`AdCP versions: ${result.adcp.major_versions.join(', ')}`);
console.log(`Supported protocols: ${result.supported_protocols.join(', ')}`);

// Check media-buy capabilities
if (result.supported_protocols.includes('media_buy')) {
  const mediaBuy = result.media_buy;

  // Check content standards support (object presence = signal)
  if (mediaBuy.content_standards) {
    console.log('Content standards supported');
  }

  // Check geo targeting (normalize native country keys and deprecated aliases)
  const postalSupport = mediaBuy.execution?.targeting?.geo_postal_areas;
  if (postalSupport?.US?.includes('zip') || postalSupport?.us_zip === true) {
    console.log('US ZIP code targeting supported');
  }

  // Portfolio overview
  console.log(`Publishers: ${mediaBuy.portfolio.publisher_domains.length}`);
}

Check multi-protocol support

const caps = await client.getAdcpCapabilities({});

const sellsMedia = caps.supported_protocols.includes('media_buy');
const managesCreatives = caps.supported_protocols.includes('creative');

if (sellsMedia && managesCreatives) {
  // Single agent handles both protocols — no need to discover a separate service
  const formats = await client.listCreativeFormats({});
  const delivery = await client.getCreativeDelivery({
    media_buy_ids: ['mb_12345']
  });
}

Filter sellers by capability

// Find sellers that support specific requirements
async function findCompatibleSellers(sellers, requirements) {
  const compatible = [];

  for (const sellerUrl of sellers) {
    const client = new AdcpClient({ baseUrl: sellerUrl });
    const caps = await client.getAdcpCapabilities({});

    if (caps.errors) continue;

    // Must support media_buy protocol
    if (!caps.supported_protocols.includes('media_buy')) continue;

    const mediaBuy = caps.media_buy;

    // Check geo targeting requirement
    if (requirements.postalCodeTargeting) {
      const postalSupport = mediaBuy.execution?.targeting?.geo_postal_areas;
      if (!(postalSupport?.US?.includes('zip') || postalSupport?.us_zip === true)) {
        continue;
      }
    }

    // Check content standards requirement (object presence = signal)
    if (requirements.contentStandards) {
      if (!mediaBuy.content_standards) {
        continue;
      }
    }

    compatible.push({ url: sellerUrl, capabilities: caps });
  }

  return compatible;
}

Use Capabilities to Build Targeting

ケイパビリティは create_media_buy ターゲティングで何を指定できるかを教えます。required_geo_targeting を使って、特定のジオターゲティングレベルとシステムをサポートするセラーにプロダクトをフィルタリングします:

// First, check capabilities
const caps = await client.getAdcpCapabilities({});

if (!caps.supported_protocols.includes('media_buy')) {
  throw new Error('Seller does not support media_buy protocol');
}

const mediaBuy = caps.media_buy;
const postalSupport = mediaBuy.execution?.targeting?.geo_postal_areas;

// Filter products to sellers with specific geo targeting capabilities
const products = await client.getProducts({
  brief: "Premium video inventory in US for ZIP-targeted campaign",
  filters: {
    channels: ['olv', 'ctv'],
    countries: ['US'],
    required_geo_targeting: [
      { level: 'postal_area', country: 'US', system: 'zip' }
    ]
  }
});

プロダクトの地理の 2 つのモデル:

Inventory Type	Filter By	Example
デジタル（display、OLV、CTV）	ケイパビリティ: `required_geo_targeting`	プロダクトは広範なカバレッジを持ち、購入時にターゲット
ローカル（radio、DOOH、ローカル TV）	カバレッジ: `metros`、`regions`	プロダクトが地理的にバインド

Local Inventory Example (Radio, DOOH)

ローカルにバインドされたインベントリでは、プロダクトが地理的に固有です。NYC DMA のラジオ局は NYC のみをカバーします。

// Find radio products in specific DMAs
const radioProducts = await client.getProducts({
  brief: "Radio inventory in NYC and LA markets",
  filters: {
    channels: ['radio'],
    metros: [
      { system: 'nielsen_dma', code: '501' },  // NYC
      { system: 'nielsen_dma', code: '803' }   // LA
    ]
  }
});

Response Example

{
  "$schema": "/schemas/protocol/get-adcp-capabilities-response.json",
  "status": "completed",
  "adcp": {
    "major_versions": [3],
    "idempotency": { "supported": true, "replay_ttl_seconds": 86400 }
  },
  "supported_protocols": ["media_buy"],
  "account": {
    "require_operator_auth": false,
    "supported_billing": ["operator", "agent"]
  },
  "media_buy": {
    "creative_approval_mode": "auto_approve",
    "features": {
      "inline_creative_management": true,
      "property_list_filtering": true
    },
    "execution": {
      "creative_specs": {
        "vast_versions": ["4.0", "4.1", "4.2"],
        "mraid_versions": ["3.0"],
        "vpaid": false,
        "simid": true
      },
      "targeting": {
        "geo_countries": true,
        "geo_regions": true,
        "geo_metros": { "nielsen_dma": true },
        "geo_postal_areas": {
          "US": ["zip", "zip_plus_four"],
          "GB": ["outward", "full"],
          "CA": ["fsa", "full"]
        },
        "language": true
      }
    },
    "content_standards": {
      "supports_local_evaluation": true,
      "supported_channels": ["display", "olv"],
      "supports_webhook_delivery": false
    },
    "audience_targeting": {
      "supported_identifier_types": ["hashed_email", "hashed_phone"],
      "supported_uid_types": ["uid2", "rampid"],
      "minimum_audience_size": 500,
      "matching_latency_hours": { "min": 1, "max": 24 }
    },
    "portfolio": {
      "publisher_domains": ["example.com", "news.example.com"],
      "primary_channels": ["display", "olv"],
      "primary_countries": ["US", "CA"]
    }
  },
  "extensions_supported": ["acmecorp"],
  "last_updated": "2025-01-23T10:00:00Z"
}

Multi-protocol agent

エージェントは単一のエンドポイントから複数のプロトコルを実装できます。これは、メディア購入とクリエイティブ生成の両方を管理するセラーで一般的です — バイヤーは同じ URL ですべてのタスクを呼び出します。

{
  "$schema": "/schemas/protocol/get-adcp-capabilities-response.json",
  "status": "completed",
  "adcp": {
    "major_versions": [3],
    "idempotency": { "supported": true, "replay_ttl_seconds": 86400 }
  },
  "supported_protocols": ["media_buy", "creative"],
  "account": {
    "require_operator_auth": false,
    "supported_billing": ["operator"]
  },
  "media_buy": {
    "creative_approval_mode": "require_human",
    "features": { "inline_creative_management": true },
    "portfolio": {
      "publisher_domains": ["news.example.com"],
      "primary_channels": ["display", "olv"]
    }
  },
  "creative": {
    "has_creative_library": true,
    "supports_generation": true,
    "supports_transformation": false,
    "supports_compliance": false,
    "bills_through_adcp": true
  }
}

supported_protocols に "creative" が含まれる場合、バイヤーはこのエージェントでクリエイティブプロトコルタスク（list_creative_formats、sync_creatives、get_creative_delivery など）を呼び出せます。セールスエージェントのクリエイティブケイパビリティを参照。

Geo Standards Reference

Level	System	Examples
Country	ISO 3166-1 alpha-2	`US`、`GB`、`DE`、`CA`
Region	ISO 3166-2	`US-NY`、`GB-SCT`、`DE-BY`、`CA-ON`
Metro (US)	`nielsen_dma`	`501`（NYC）、`803`（LA）、`602`（Chicago）
Metro (UK)	`uk_itl2`	`UKI`（London）、`UKD`（North West）
Metro (EU)	`eurostat_nuts2`	`DE30`（Berlin）、`FR10`（Île-de-France）
Postal (US)	`US` / `zip`	`10001`、`90210`
Postal (US)	`US` / `zip_plus_four`	`10001-1234`
Postal (UK)	`GB` / `outward`	`SW1`、`EC1`、`M1`
Postal (UK)	`GB` / `full`	`SW1A 1AA`
Postal (CA)	`CA` / `fsa`	`K1A`、`M5V`

Migration from list_authorized_properties (v2)

list_authorized_properties タスクは v3 で削除されました。v2 から移行する場合:

Old Field	New Location
`publisher_domains`	`media_buy.portfolio.publisher_domains`
`primary_channels`	`media_buy.portfolio.primary_channels`
`primary_countries`	`media_buy.portfolio.primary_countries`
`portfolio_description`	`media_buy.portfolio.description`
`advertising_policies`	`media_buy.portfolio.advertising_policies`
`last_updated`	`last_updated`（トップレベル）

新しいフィールド:

adcp.major_versions - バージョン互換性
supported_protocols - どのドメインプロトコルがサポートされるか
media_buy.features - 任意の機能サポート
media_buy.execution.targeting - ジオターゲティング粒度

Error Handling

Error Code	Description	Resolution
`AUTH_MISSING`	認証情報が提示されていない	auth ヘッダーで認証情報を提供
`AUTH_INVALID`	認証情報が拒否された（期限切れ / 失効）	人間による認証情報のローテーションが必要
`VERSION_UNSUPPORTED`	宣言された `adcp_major_version` がセラーの `major_versions` にない	`adcp_major_version` なしで呼び出してサポートバージョンを発見し、リトライ
`INTERNAL_ERROR`	サーバーエラー	バックオフを伴ってリトライ

Best Practices

1. ケイパビリティをキャッシュする ケイパビリティはめったに変わりません。結果をキャッシュし、古さの検出に last_updated を使います。 2. まずプロトコルサポートを確認する プロトコル固有のフィールドにアクセスする前に、プロトコルが supported_protocols にあることを検証します。 3. リクエスト前に確認する セラーがサポートしないシステムの郵便エリアを送らないでください。セラーがサポートしない機能をリクエストしないでください。 4. 非互換で早期に失敗する セラーが必要なケイパビリティをサポートしない場合、後で失敗を発見するのではなく早期にスキップします。 5. 続行前に認証モデルを読む ディスカバリー直後に account.require_operator_auth を確認します。エージェント信頼とオペレータースコープのフローは大きく異なります。 6. ルーティングにプロトコルバージョンを使う adcp.major_versions に基づいて適切な API バージョンにリクエストをルーティングします。

Next Steps

ケイパビリティを発見した後:

アカウントをセットアップ: account.require_operator_auth の認証モデルに従う — アカウントとエージェントを参照
プロダクトをフィルタリング: ケイパビリティ認識フィルターで get_products を使う
プロパティを検証: プロパティ定義のためにパブリッシャーの adagents.json ファイルを取得
バイを作成: サポートされる機能で create_media_buy を使う

Learn More

アカウントとエージェント - 認証モデル、アカウントセットアップ、課金
adagents.json 仕様 - パブリッシャー認可ファイル
プロダクトフィルター - ケイパビリティ認識フィルタリング
コンテンツ標準 - ブランドセーフティ設定

​Tool-Based Discovery

​Version Negotiation

​Request Parameters

​Response Structure

​adcp

​idempotency

​supported_protocols

​specialisms

​Capability slot gaps

​account

​Auth models

​media_buy

​reporting_delivery_methods

​creative_approval_mode

​features

​content_standards

​execution

axe_integrations

creative_specs

targeting

​audience_targeting

​conversion_tracking

​portfolio

​signals

​creative

​governance

​property_features

​creative_features

​content_standards

​policy_registry

​measurement

​metrics

​compliance_testing

​webhook_signing

​extensions_supported

​experimental_features

​wholesale_feed_versioning

​wholesale_feed_webhooks

​The Capability Contract

​Common Scenarios

​Basic Capability Discovery

​Check multi-protocol support

​Filter sellers by capability

​Use Capabilities to Build Targeting

​Local Inventory Example (Radio, DOOH)

​Response Example

​Multi-protocol agent

​Geo Standards Reference

​Migration from list_authorized_properties (v2)

​Error Handling

​Best Practices

​Next Steps

​Learn More

Tool-Based Discovery

Version Negotiation

Request Parameters

Response Structure

adcp

idempotency

supported_protocols

specialisms

Capability slot gaps

account

Auth models

media_buy

reporting_delivery_methods

creative_approval_mode

features

content_standards

execution

audience_targeting

conversion_tracking

portfolio

signals

creative

governance

property_features

creative_features

content_standards

policy_registry

measurement

metrics

compliance_testing

webhook_signing

extensions_supported

experimental_features

wholesale_feed_versioning

wholesale_feed_webhooks

The Capability Contract

Common Scenarios

Basic Capability Discovery

Check multi-protocol support

Filter sellers by capability

Use Capabilities to Build Targeting

Local Inventory Example (Radio, DOOH)

Response Example

Multi-protocol agent

Geo Standards Reference

Migration from list_authorized_properties (v2)

Error Handling

Best Practices

Next Steps

Learn More