すべてのタスク概要
| Task | Purpose | Response Time | Phase |
|---|---|---|---|
get_products | 自然言語ブリーフで在庫を探索 | 約 60 秒 | Discovery |
create_media_buy | 選択したプロダクトからキャンペーンを作成 | 数分～数日 | Media Buys |
update_media_buy | キャンペーン設定と予算を更新 | 数分～数日 | Media Buys |
list_creative_formats | サポートするクリエイティブ仕様を確認 | 約 1 秒 | Capability |
sync_creatives | クリエイティブアセットをアップロード・管理 | 数分～数日 | Creatives |
list_creatives | フィルタ付きでクリエイティブライブラリを検索 | 約 1 秒 | Creatives |
get_media_buy_delivery | 配信とパフォーマンスデータを取得 | 約 60 秒 | Reporting |
レスポンスタイムのカテゴリ
AdCP のタスクは 4 つのレスポンスタイムカテゴリに分類されます。🟢 即時（約 1 秒）
簡単なデータベース参照list_creative_formats- フォーマット仕様list_creatives- クリエイティブライブラリ検索
🟡 処理中（約 60 秒）
バックエンドと連携した AI/LLM 推論get_products- 自然言語によるプロダクト探索get_media_buy_delivery- パフォーマンスデータ集計
🟠 非同期（数分～数日）
人による承認が入る可能性のある複雑な処理create_media_buy- キャンペーン作成と検証update_media_buy- キャンペーンの変更sync_creatives- クリエイティブアセット処理
ワークフロー別のタスク分類
ディスカバリーと計画
利用可能な内容を把握し、キャンペーンを計画する起点。get_adcp_capabilities- エージェントの機能、ポートフォリオ、サポート機能を発見（プロトコルレベルのタスク）get_products- 自然言語ブリーフを使う中核のディスカバリータスクlist_creative_formats- クリエイティブ要件を把握
メディアバイ管理
広告キャンペーンを作成・管理します。create_media_buy- 発見したプロダクトからキャンペーンを作成update_media_buy- 予算、ターゲティング、設定を変更
クリエイティブ管理
クリエイティブアセットのライフサイクル全体を扱います。sync_creatives- アセットを中央ライブラリにアップロードlist_creatives- クリエイティブライブラリを検索・管理
パフォーマンスと最適化
キャンペーンパフォーマンスを監視・最適化します。get_media_buy_delivery- 配信と成果指標を追跡
スキーマリファレンス
すべてのタスクにはリクエストとレスポンスの JSON スキーマ定義が含まれます。- Request Schemas:
/schemas/v2/media-buy/[task-name]-request.json - Response Schemas:
/schemas/v2/media-buy/[task-name]-response.json
共通パターン
エラーハンドリング
すべてのタスクは一貫したエラーパターンに従います。- エラータイプに応じた HTTP ステータスコード
- 文脈を含む構造化されたエラーメッセージ
- 一時的な失敗に対するリトライ指針
認証
タスクは適切な認証を必要とします。- サービス間呼び出しには API キー
- マルチテナント運用にはプリンシパルコンテキスト
- リソースアクセスにはパーミッション検証
非同期処理
長時間実行タスクは以下を提供します。- オペレーション ID を含む即時レスポンス
- 進捗確認用のステータスポーリングエンドポイント
- 完了を通知する Webhook
はじめに
- 機能を発見する:
get_adcp_capabilitiesでエージェントの対応状況を把握します - 在庫を見つける:
get_productsで関連在庫を探す - フォーマットを理解する:
list_creative_formatsで要件を確認します - キャンペーンを作成: 選択したプロダクトで
create_media_buyを実行します - クリエイティブをアップロード:
sync_creativesでアセットを管理します - 成果を監視:
get_media_buy_deliveryで結果を追跡します
関連ドキュメント
- Product Discovery - 自然言語による在庫探索
- Media Buys - キャンペーンライフサイクル管理
- Creatives - クリエイティブアセット管理
- Advanced Topics - ターゲティング、セキュリティ、アーキテクチャ