​

media_buy_status への移行（3.1）

• エンベロープ status — TaskStatus（submitted / working / input-required / completed / canceled / failed / rejected / auth-required / unknown）。beta.2 から必須（#4876）。
• ボディ media_buy_status — MediaBuyStatus（pending_creatives / pending_start / active / paused / completed / rejected / canceled）。3.1 で新規。

​

何が変わったか

​

Before（3.0）

{
  "status": "completed",
  "media_buy_id": "mb_12345",
  "status": "active",
  "packages": [...]
}

​

After（3.1）

{
  "status": "completed",
  "media_buy_id": "mb_12345",
  "media_buy_status": "active",
  "packages": [...]
}

​

3.1 適合性

• セラー は create_media_buy と update_media_buy の成功レスポンスに media_buy_status を発すべき（SHOULD）。3.1 非推奨ウィンドウ中は非推奨のトップレベル status: MediaBuyStatus を発し続けてもよい（MAY）。
• バイヤー は存在するとき media_buy_status を優先しなければならない（MUST）。レガシー形式のままのセラーとの互換性のためにレガシー status にフォールバックしてもよい（MAY）。
• 3.0 セラーとバイヤー は変更なく動作し続けます。required[] のスワップなし、リネームなし、破壊なし。
• コンプライアンスストーリーボード は path: "media_buy_status" をアサートします。レガシー status のみを発する 3.1 セラーはスキーマ有効ですが、3.1 ストーリーボード認証に失敗します。ストーリーボードが拘束力のある適合性チェックです。スキーマの deprecated: true マーカーは助言的です。
• 両フィールドを発するセラー は、media_buy_status と非推奨の status に同一の値を発しなければなりません（MUST）。分岐した発行（例: status: "active", media_buy_status: "paused"）は JSON Schema 検証を通過しますが適合性違反です — 3.1 ストーリーボードは、正準の media_buy_status チェックと並んで status の field_value_or_absent アサーションを通じて等価を強制します。if/then JSON Schema 制約は評価され延期されました: 移行ウィンドウが短く、codegen ツールチェーンの互換性が不確実で、ストーリーボードゲートで十分だからです。#4908 を参照。

​

SDK の動作

​

レガシーフィールドが消えるとき

• 3.2（#4906）: 非推奨のトップレベル status: MediaBuyStatus が CreateMediaBuySuccess と UpdateMediaBuySuccess から 削除 されます。3.2 の後、これらのレスポンスのトップレベル status は明確にエンベロープ TaskStatus のみを運びます。非推奨ウィンドウは意図的に短い — ストーリーボードゲートがすでに 3.1 準拠セラーをレガシーフィールドから追い出します。
• 4.0（#4905）: ネストされた status カスケードが着地します — get-media-buys-response の media_buys[].status、get-media-buy-delivery-response の media_buy_deliveries[].status、core/media-buy.json の status が media_buy_status にリネーム。真に破壊的（required[] スワップ）で、メジャーに保留。

​

前方互換のバイヤーコード

// media_buy_status（3.1+）を優先、status（3.0 + 4.0 ネストサーフェス互換）にフォールバック
const mediaBuyStatus = response.media_buy_status ?? response.status;
const buyLifecycleStatus = mediaBuy.media_buy_status ?? mediaBuy.status;

​

関連

• create_media_buy リファレンス — 正準レスポンス例
• メディアバイライフサイクル — MediaBuyStatus ステートマシン
• エンベロープ task-status — TaskStatus セマンティクス