> ## 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. # get_plan_audit_logs > get_plan_audit_logs は AdCP キャンペーンプランまたはポートフォリオのガバナンス状態、予算追跡、完全な監査証跡を取得します。 # get\_plan\_audit\_logs プラン、複数のプラン、またはポートフォリオ全体のガバナンス状態と監査証跡を取得します。予算追跡、検証履歴、コンプライアンスサマリーを返します。 ## リクエスト ```json theme={null} { "tool": "get_plan_audit_logs", "arguments": { "plan_ids": ["plan_q1_2026_launch"], "include_entries": true } } ``` 結果は各プラン内で `media_buy_id` ごとにグループ化されます。 **複数プラン** — 1回の呼び出しで特定のプランを取得します: ```json theme={null} { "tool": "get_plan_audit_logs", "arguments": { "plan_ids": ["plan_q1_2026_launch", "plan_q1_2026_emea"], "include_entries": false } } ``` **ポートフォリオクエリ** — 1つ以上のポートフォリオのすべてのメンバープランの統合監査データを取得します: ```json theme={null} { "tool": "get_plan_audit_logs", "arguments": { "portfolio_plan_ids": ["portfolio_nova_brands_2026"], "include_entries": true } } ``` `plan_ids` と `portfolio_plan_ids` を組み合わせて、1回の呼び出しで特定のプランとポートフォリオの両方をクエリできます。 ## レスポンス ```json theme={null} { "plans": [ { "plan_id": "plan_q1_2026_launch", "plan_version": 1, "status": "active", "budget": { "authorized": 500000, "committed": 425000, "remaining": 75000, "utilization_pct": 85 }, "channel_allocation": { "olv": { "committed": 275000, "pct": 55 }, "display": { "committed": 150000, "pct": 30 } }, "media_buys": [ { "media_buy_id": "mb_seller_456", "status": "active", "committed": 275000, "check_count": 8 }, { "media_buy_id": "mb_seller_789", "status": "active", "committed": 150000, "check_count": 7 } ], "summary": { "checks_performed": 15, "outcomes_reported": 12, "statuses": { "approved": 12, "denied": 1, "conditions": 1, "escalated": 1 }, "findings_count": 2, "escalations": [ { "check_id": "chk_esc_001", "reason": "Budget reallocation exceeds threshold", "resolution": "approved_by_human", "resolved_at": "2026-03-16T09:30:00Z" } ], "drift_metrics": { "escalation_rate": 0.07, "escalation_rate_trend": "stable", "auto_approval_rate": 0.80, "human_override_rate": 0.02, "mean_confidence": 0.88, "thresholds": { "escalation_rate_min": 0.02, "auto_approval_rate_max": 0.95, "human_override_rate_max": 0.15 } } }, "entries": [ { "id": "chk_001", "type": "check", "timestamp": "2026-03-10T10:05:00Z", "caller": "https://orchestrator.pinnacle-media.com/agent", "tool": "get_products", "status": "approved", "binding": "proposed", "explanation": "Product discovery within budget and channel constraints.", "categories_evaluated": ["budget_authority", "strategic_alignment"], "policies_evaluated": ["us_coppa"] }, { "id": "chk_003", "type": "check", "timestamp": "2026-03-15T11:05:00Z", "caller": "https://ads.seller-example.com/adcp", "tool": "create_media_buy", "status": "approved", "binding": "committed", "explanation": "Media buy within plan budget ($150,000 of $500,000 remaining). Geo targeting matches authorized markets. COPPA compliance verified.", "categories_evaluated": ["budget_authority", "regulatory_compliance", "brand_policy"], "policies_evaluated": ["us_coppa", "alcohol_advertising"], "findings": [ { "category_id": "budget_authority", "severity": "info", "explanation": "Budget utilization at 70% after this buy." } ] }, { "id": "out_001", "type": "outcome", "timestamp": "2026-03-15T11:10:00Z", "caller": "https://orchestrator.pinnacle-media.com/agent", "outcome": "completed", "committed_budget": 150000 }, { "id": "out_del_001", "type": "outcome", "timestamp": "2026-03-22T00:00:00Z", "caller": "https://ads.seller-example.com/adcp", "outcome": "delivery", "media_buy_id": "mb_seller_456", "outcome_status": "accepted" } ] } ] } ``` ## フィールド ### リクエスト | フィールド | 型 | 必須 | 説明 | | -------------------- | --------- | ----------------------------------------- | ----------------------------- | | `plan_ids` | string\[] | `plan_ids` または `portfolio_plan_ids` のいずれか | 取得するプラン ID。 | | `portfolio_plan_ids` | string\[] | `plan_ids` または `portfolio_plan_ids` のいずれか | ポートフォリオプラン ID。メンバープランに展開されます。 | | `include_entries` | boolean | No | 完全な監査証跡を含めます。デフォルト: `false`。 | ### レスポンス | フィールド | 型 | 説明 | | ------------------------------------------------------------------ | ------- | -------------------------------------------------------------------------------------------- | | `plans` | array | リクエストされた各プランの監査データ。 | | `plans[].plan_id` | string | プラン識別子。 | | `plans[].plan_version` | number | 現在のプランバージョン。 | | `plans[].status` | enum | `active`、`suspended`、または `completed`。 | | `plans[].budget` | object | 予算状態。 | | `plans[].budget.authorized` | number | プランで認可された総予算。 | | `plans[].budget.committed` | number | 確認済みの結果からコミットされた総予算。 | | `plans[].budget.remaining` | number | 認可額からコミット済み額を引いたもの。 | | `plans[].budget.utilization_pct` | number | 認可額に対するコミット済み額のパーセンテージ。 | | `plans[].channel_allocation` | object | 現在のチャンネルミックス。チャンネル ID をキーとします。 | | `plans[].channel_allocation[channel].committed` | number | このチャンネルにコミットされた予算。 | | `plans[].channel_allocation[channel].pct` | number | 認可された総予算に対するチャンネルのシェア。 | | `plans[].media_buys` | array | メディアバイごとの内訳。 | | `plans[].media_buys[].media_buy_id` | string | セラーが割り当てたメディアバイ識別子。 | | `plans[].media_buys[].status` | enum | `active`、`suspended`、または `completed`。 | | `plans[].media_buys[].committed` | number | このメディアバイにコミットされた予算。 | | `plans[].media_buys[].check_count` | integer | 実行されたガバナンスチェックの数。 | | `plans[].summary` | object | 集計された検証と結果の統計。 | | `plans[].summary.checks_performed` | number | 実行されたガバナンスチェックの総数。 | | `plans[].summary.outcomes_reported` | number | 報告された結果の総数。 | | `plans[].summary.statuses` | object | 各ガバナンスチェックステータスのカウント（`approved`、`denied`、`conditions`、`escalated`）。 | | `plans[].summary.findings_count` | number | すべてのチェックと結果にわたる検出事項の総数。 | | `plans[].summary.escalations` | array | すべてのエスカレーションとその解決策。 | | `plans[].summary.escalations[].check_id` | string | エスカレーションされたガバナンスチェック。 | | `plans[].summary.escalations[].reason` | string | エスカレーションされた理由。 | | `plans[].summary.escalations[].resolution` | string | 解決方法（例: `approved_by_human`、`rejected_by_human`）。 | | `plans[].summary.escalations[].resolved_at` | string | ISO 8601 解決タイムスタンプ。 | | `plans[].summary.drift_metrics` | object | 監視ドリフトを検出するための集計ガバナンスメトリクス。[仕様](/docs/governance/campaign/specification#drift-detection)を参照。 | | `plans[].summary.drift_metrics.escalation_rate` | number | エスカレーションに至ったチェックの割合（0-1）。 | | `plans[].summary.drift_metrics.escalation_rate_trend` | enum | `increasing`、`stable`、または `declining`。 | | `plans[].summary.drift_metrics.auto_approval_rate` | number | 人間の介入なしに承認されたチェックの割合（0-1）。 | | `plans[].summary.drift_metrics.human_override_rate` | number | 人間がエージェントをオーバーライドしたエスカレーションの割合（0-1）。 | | `plans[].summary.drift_metrics.mean_confidence` | number | 検出事項全体の平均信頼スコア（0-1）。検出事項に信頼度が含まれる場合に存在します。 | | `plans[].summary.drift_metrics.thresholds` | object | ドリフトメトリクスの組織定義の閾値。メトリクスが閾値を超えると、ガバナンスエージェントは検出事項を含めます。 | | `plans[].summary.drift_metrics.thresholds.escalation_rate_max` | number | 許容できる最大エスカレーション率。 | | `plans[].summary.drift_metrics.thresholds.escalation_rate_min` | number | 許容できる最小エスカレーション率。この値を下回る率は監視の侵食を示す可能性があります。 | | `plans[].summary.drift_metrics.thresholds.auto_approval_rate_max` | number | 許容できる最大自動承認率。 | | `plans[].summary.drift_metrics.thresholds.human_override_rate_max` | number | 許容できる最大人間オーバーライド率。 | | `plans[].entries` | array | 順序付けられた監査証跡（`include_entries` が `true` の場合のみ）。 | | `plans[].entries[].id` | string | エントリー識別子。 | | `plans[].entries[].type` | enum | `check` または `outcome`。 | | `plans[].entries[].timestamp` | string | ISO 8601 タイムスタンプ。 | | `plans[].entries[].plan_id` | string | このエントリーが属するプラン。複数のプランまたはポートフォリオをクエリする場合に存在します。 | | `plans[].entries[].caller` | string | リクエストを行ったエージェントの URL。ガバナンスコールバックで使用されたクレデンシャルから解決されます。 | | `plans[].entries[].tool` | string | AdCP ツール（`check` エントリーに存在）。 | | `plans[].entries[].status` | enum | ガバナンスチェックステータス（`check` エントリーに存在）。 | | `plans[].entries[].binding` | enum | `proposed` または `committed`（`check` エントリーに存在）。 | | `plans[].entries[].explanation` | string | ガバナンス決定の人間が読める説明（`check` エントリーに存在）。 | | `plans[].entries[].policies_evaluated` | array | このチェック中に評価されたレジストリポリシー ID。 | | `plans[].entries[].categories_evaluated` | array | 評価されたガバナンスカテゴリ（例: `budget_authority`、`regulatory_compliance`）。 | | `plans[].entries[].findings` | array | このチェックからの検出事項。カテゴリ、深刻度、ポリシー ID、説明、信頼度を含みます。 | | `plans[].entries[].outcome` | enum | 結果タイプ（`outcome` エントリーに存在）。 | | `plans[].entries[].committed_budget` | number | コミットされた予算（`completed` 結果エントリーに存在）。 | | `plans[].entries[].media_buy_id` | string | メディアバイ ID（`delivery` 結果エントリーに存在）。 | | `plans[].entries[].outcome_status` | string | 結果ステータス（`outcome` エントリーに存在）。 | ## 認可 リクエストスキーマにはエンベロープの `account` フィールドがありません — テナントの識別は送信された ID から解決されます。ガバナンスエージェントは、認証済みプリンシパルが、すべての `plan_ids` メンバー、`portfolio_plan_ids` から展開されるすべてのプラン、`governance_contexts` が指すすべての被管理アクションについて認可されていることを検証しなければなりません（MUST）。いずれかの要素が認可チェックに失敗した場合、ガバナンスエージェントは汎用的な `PLAN_NOT_FOUND` レスポンスでフェイルクローズしなければなりません（MUST）— エラーボディは「未認可」と「見つからない」を区別してはならず、問題の ID を名指ししてはなりません（MUST NOT）。パターンと存在漏洩のガードレールについては [エージェントとアカウントの分離](/docs/building/by-layer/L1/security#エージェントとアカウントの分離) を参照。 ## エラーコード | コード | 回復 | 説明 | | ---------------- | ----------- | ---------------------------- | | `PLAN_NOT_FOUND` | correctable | この ID のプランが存在しないか、認可されていません。 | ## 関連タスク * [`sync_plans`](./sync_plans) — プランをプッシュまたは更新します * [`check_governance`](./check_governance) — プランに対してアクションを検証します * [`report_plan_outcome`](./report_plan_outcome) — プラン状態を更新するために結果を報告します