> ## 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 メディアバイのタスクリファレンス — プロダクトディスカバリー、キャンペーン作成、配信レポート、クリエイティブ、オーディエンス、コンバージョントラッキングの全タスクを、スキーマと例とともに解説します。

すべての AdCP メディアバイタスクの完全なリファレンスです。各タスクは、広告ワークフローの特定部分を AI エージェントが自動化できるよう設計されています。

## すべてのタスク概要

| タスク                                                                                           | 目的                                   | レスポンスタイム | フェーズ          |
| --------------------------------------------------------------------------------------------- | ------------------------------------ | -------- | ------------- |
| [`get_products`](/docs/media-buy/task-reference/get_products)                                 | 在庫を発見しプロダクトを絞り込む                     | 約60秒     | ディスカバリー       |
| [`create_media_buy`](/docs/media-buy/task-reference/create_media_buy)                         | 選択したプロダクトからキャンペーンを作成                 | 数分〜数日    | メディアバイ        |
| [`update_media_buy`](/docs/media-buy/task-reference/update_media_buy)                         | キャンペーン設定と予算を変更                       | 数分〜数日    | メディアバイ        |
| [`list_creative_formats`](/docs/creative/task-reference/list_creative_formats)                | サポートされるクリエイティブ仕様を表示                  | 約1秒      | ケイパビリティ       |
| [`sync_catalogs`](/docs/media-buy/task-reference/sync_catalogs)                               | カタログフィード（プロダクト、店舗、在庫）を同期             | 数分〜数日    | カタログ          |
| [`sync_creatives`](/docs/creative/task-reference/sync_creatives)                              | クリエイティブアセットをアップロード・管理                | 数分〜数日    | クリエイティブ       |
| [`list_creatives`](/docs/creative/task-reference/list_creatives)                              | フィルタリングでクリエイティブライブラリを照会              | 約1秒      | クリエイティブ       |
| [`get_media_buys`](/docs/media-buy/task-reference/get_media_buys)                             | メディアバイのステータス、クリエイティブ承認、配信スナップショットを取得 | 約1秒      | モニタリング        |
| [`get_media_buy_delivery`](/docs/media-buy/task-reference/get_media_buy_delivery)             | パフォーマンスと配信データを取得                     | 約60秒     | レポート          |
| [`provide_performance_feedback`](/docs/media-buy/task-reference/provide_performance_feedback) | 最適化のためのパフォーマンスシグナルを送信                | 約1秒      | 最適化           |
| [`sync_event_sources`](/docs/media-buy/task-reference/sync_event_sources)                     | コンバージョントラッキング用のイベントソースを設定            | 約1秒      | コンバージョントラッキング |
| [`log_event`](/docs/media-buy/task-reference/log_event)                                       | アトリビューションのためのマーケティングイベントを送信          | 約1秒      | コンバージョントラッキング |
| [`sync_audiences`](/docs/media-buy/task-reference/sync_audiences)                             | ファーストパーティ CRM オーディエンスをアップロード・管理      | 数分〜数日    | オーディエンス       |

## レスポンスタイムのカテゴリ

AdCP タスクは四つのレスポンスタイムのカテゴリに分かれます:

### 🟢 即時（約 1 秒）

**単純な参照とイベント取り込み**

* [`list_creative_formats`](/docs/creative/task-reference/list_creative_formats) - フォーマット仕様
* [`list_creatives`](/docs/creative/task-reference/list_creatives) - クリエイティブライブラリの照会
* [`get_media_buys`](/docs/media-buy/task-reference/get_media_buys) - メディアバイのステータスとクリエイティブ承認
* [`provide_performance_feedback`](/docs/media-buy/task-reference/provide_performance_feedback) - パフォーマンスシグナルの送信
* [`sync_event_sources`](/docs/media-buy/task-reference/sync_event_sources) - イベントソースの設定
* [`log_event`](/docs/media-buy/task-reference/log_event) - イベントの取り込み

### 🟡 処理中（約 60 秒）

**バックエンドシステムを伴う AI/LLM 推論**

* [`get_products`](/docs/media-buy/task-reference/get_products) - 自然言語のプロダクトディスカバリーと絞り込み
* [`get_media_buy_delivery`](/docs/media-buy/task-reference/get_media_buy_delivery) - パフォーマンスデータの集計

### 🟠 非同期（数分〜数日）

**人による承認の可能性を伴う複雑な操作**

* [`create_media_buy`](/docs/media-buy/task-reference/create_media_buy) - キャンペーンの作成と検証
* [`update_media_buy`](/docs/media-buy/task-reference/update_media_buy) - キャンペーンの変更
* [`sync_catalogs`](/docs/media-buy/task-reference/sync_catalogs) - カタログフィードの処理とレビュー
* [`sync_creatives`](/docs/creative/task-reference/sync_creatives) - クリエイティブアセットの処理
* [`sync_audiences`](/docs/media-buy/task-reference/sync_audiences) - オーディエンスのマッチングと処理

## ワークフロー別のタスク分類

### アカウント管理

メディアバイを行う前に、セラーとの商業的関係を確立します。これらのタスクはすべてのベンダープロトコルで共有され、コマースプロトコルのセクションに存在します:

* **[`sync_accounts`](/docs/accounts/tasks/sync_accounts)** - ブランド/オペレーターのペアと請求を宣言し、セラーがアカウントをプロビジョニングする
* **[`list_accounts`](/docs/accounts/tasks/list_accounts)** - アカウントのステータスを確認し、アクティブな `account_id` の値を取得する

### ディスカバリーと計画

何が利用可能かを理解し、キャンペーンを計画するにはここから始めます。

* **[`get_adcp_capabilities`](/docs/protocol/get_adcp_capabilities)** - エージェントのケイパビリティ、ポートフォリオ、サポートされる機能を発見する（プロトコルレベルのタスク）
* **[`get_products`](/docs/media-buy/task-reference/get_products)** - 自然言語ブリーフを使う中核のディスカバリータスク
* **[`list_creative_formats`](/docs/creative/task-reference/list_creative_formats)** - クリエイティブ要件を理解する

### メディアバイ管理

広告キャンペーンを作成し管理します。

* **[`create_media_buy`](/docs/media-buy/task-reference/create_media_buy)** - 発見したプロダクトからキャンペーンを作成する
* **[`update_media_buy`](/docs/media-buy/task-reference/update_media_buy)** - 予算、ターゲティング、設定を変更する

### カタログ管理

プロダクトフィード、在庫、店舗データをセラーアカウントに同期します。

* **[`sync_catalogs`](/docs/media-buy/task-reference/sync_catalogs)** - プラットフォームのレビューと承認を伴ってカタログフィードをプッシュする

### クリエイティブ管理

クリエイティブアセットをライフサイクル全体にわたって扱います。

* **[`sync_creatives`](/docs/creative/task-reference/sync_creatives)** - エージェントがホストするクリエイティブライブラリにアセットをアップロードする
* **[`list_creatives`](/docs/creative/task-reference/list_creatives)** - クリエイティブライブラリを検索・管理する（クリエイティブプロトコル）
* **インラインの `packages[].creatives`** - セラーがクリエイティブライブラリなしで `inline_creative_management` を表明する場合に、パッケージスコープのクリエイティブ本体を添付または置換する

### パフォーマンスと最適化

キャンペーンのパフォーマンスをモニタリングし最適化します。

* **[`get_media_buys`](/docs/media-buy/task-reference/get_media_buys)** - キャンペーンのステータス、クリエイティブ承認、ほぼリアルタイムの配信スナップショットを確認する
* **[`get_media_buy_delivery`](/docs/media-buy/task-reference/get_media_buy_delivery)** - レポートのために配信とパフォーマンス指標を追跡する
* **[`provide_performance_feedback`](/docs/media-buy/task-reference/provide_performance_feedback)** - パブリッシャーの最適化のためにパフォーマンスシグナルを送信する

### コンバージョントラッキング

イベントソースを設定し、アトリビューションのためにマーケティングイベントを送信します。

* **[`sync_event_sources`](/docs/media-buy/task-reference/sync_event_sources)** - セラーアカウント上のイベントソースを設定する
* **[`log_event`](/docs/media-buy/task-reference/log_event)** - アトリビューションのためにマーケティングイベントを送信する

### オーディエンス管理

ターゲティングのためにファーストパーティ CRM オーディエンスをアップロードし管理します。

* **[`sync_audiences`](/docs/media-buy/task-reference/sync_audiences)** - ハッシュ化された顧客リストをアップロードし、マッチングステータスを確認する

## スキーマリファレンス

すべてのタスクには、リクエストとレスポンスの JSON スキーマ定義が含まれます:

* **リクエストスキーマ**: `/schemas/v3/media-buy/[task-name]-request.json`
* **レスポンススキーマ**: `/schemas/v3/media-buy/[task-name]-response.json`

**タスク管理**: すべての AdCP ドメインにまたがる非同期操作の追跡については、[タスクライフサイクル](/docs/building/by-layer/L3/task-lifecycle)を参照してください。

スキーマは、検証とツーリングのためにドキュメントサーバーを通じて実行時にアクセスできます。

## 共通パターン

### タスク命名規約

タスク名は snake\_case を使い、メディアバイ全体で一貫して動詞優先のセマンティクスに従います:

* `get_*`: 現在の状態またはスコープされたデータセットを取得する（例: `get_products`、`get_media_buys`、`get_media_buy_delivery`）
* `list_*`: 任意のフィルタリングを伴ってコレクションを列挙する（例: `list_creative_formats`、`list_creatives`）
* `create_*`: 新しいリソースを作成する（`create_media_buy`）
* `update_*`: 既存のリソースに部分更新を適用する（`update_media_buy`）
* `sync_*`: 外部の状態をアップサート的な振る舞いでセラーシステムに突き合わせる（`sync_catalogs`、`sync_creatives`、`sync_event_sources`）
* `log_*`: 追記専用のイベントレコードを取り込む（`log_event`）
* `provide_*`: 最適化またはフィードバックのシグナルを送信する（`provide_performance_feedback`）

### エラーハンドリング

すべてのタスクは、次を伴う一貫したエラーパターンに従います:

* 異なるエラータイプに対する HTTP ステータスコード
* コンテキストを持つ構造化されたエラーメッセージ
* 一時的な失敗に対するリトライのガイダンス

### 認証

タスクは次を通じて適切な認証を要求します:

* サービス間呼び出しのための API キー
* マルチテナント操作のための認証済みエージェントとアカウントのスコープ
* リソースアクセスのための権限検証

### 非同期オペレーション

長時間実行のタスクは次を提供します:

* 操作 ID を伴う即時レスポンス
* 進捗のためのステータスポーリングエンドポイント
* 完了のためのウェブフック通知

## はじめに

1. **ケイパビリティを発見する**: [`get_adcp_capabilities`](/docs/protocol/get_adcp_capabilities) を使って、エージェントが何をサポートするかを理解する
2. **在庫を見つける**: [`get_products`](/docs/media-buy/task-reference/get_products) を使って、関連する在庫を見つける
3. **プロダクトを絞り込む**: `buying_mode: "refine"` を指定して [`get_products`](/docs/media-buy/task-reference/get_products) を再呼び出しし、予算、価格、ターゲティングを反復する
4. **フォーマットを理解する**: 要件について [`list_creative_formats`](/docs/creative/task-reference/list_creative_formats) を確認する
5. **カタログを同期する**: [`sync_catalogs`](/docs/media-buy/task-reference/sync_catalogs) を使って、プロダクトフィードをアカウントにプッシュする
6. **クリエイティブを供給する**: ライブラリを持つセラーには [`sync_creatives`](/docs/creative/task-reference/sync_creatives) を、インライン専用のセラーにはインラインの `packages[].creatives` を使う
7. **キャンペーンを作成する**: 選択したプロダクトで [`create_media_buy`](/docs/media-buy/task-reference/create_media_buy) を使う
8. **運用状態を確認する**: ステータス、承認、不足フォーマットについて [`get_media_buys`](/docs/media-buy/task-reference/get_media_buys) を使う
9. **パフォーマンスをモニタリングする**: [`get_media_buy_delivery`](/docs/media-buy/task-reference/get_media_buy_delivery) でレポート指標を追跡する

レポートと照合については、[`get_media_buy_delivery`](/docs/media-buy/task-reference/get_media_buy_delivery) を権威ある請求グレードの情報源として扱います。[`get_media_buys`](/docs/media-buy/task-reference/get_media_buys) のスナップショットは運用モニタリングにのみ使います。

## 関連ドキュメント

* **[プロダクトディスカバリー](/docs/media-buy/product-discovery/)** - 自然言語による在庫の発見
* **[メディアバイ](/docs/media-buy/media-buys/)** - キャンペーンのライフサイクル管理
* **[クリエイティブ](/docs/media-buy/creatives/)** - クリエイティブアセットの管理
* **[高度なトピック](/docs/media-buy/advanced-topics/)** - ターゲティング、セキュリティ、アーキテクチャ