addashboard-cli 0.9.1 → 0.9.3

package/dist/commands/status.js

@@ -0,0 +1,188 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STATUS_MAX_IDS = exports.STATUS_LEVELS = exports.STATUS_PLATFORMS = void 0;
+exports.parseIds = parseIds;
+exports.formatStatusSummary = formatStatusSummary;
+exports.runUpdateStatus = runUpdateStatus;
+const fs_1 = __importDefault(require("fs"));
+const apiClient_1 = require("../lib/apiClient");
+const apiError_1 = require("../lib/apiError");
+/** ステータス更新に対応している媒体。現状 YDA のみ (Meta 以降は未実装)。 */
+exports.STATUS_PLATFORMS = ['yda'];
+exports.STATUS_LEVELS = ['campaign', 'adGroup', 'ad'];
+/** backend が ids に載せる上限。ここでも先に弾いて無駄な往復を避ける。 */
+exports.STATUS_MAX_IDS = 200;
+/**
+ * ID 列をパースする。
+ *
+ * 貼り付け元が管理画面のコピペ・CSV・改行区切りテキストのいずれでも通るように、
+ * カンマ / 空白 / 改行 / タブ をすべて区切りとして扱う。
+ * 重複は畳む (同じ ID を2回送っても set を2回叩く意味がなく、件数上限の判定も狂う)。
+ */
+function parseIds(raw) {
+    return Array.from(new Set(raw
+        .split(/[\s,]+/)
+        .map((s) => s.trim())
+        .filter(Boolean)));
+}
+const LEVEL_LABEL = {
+    campaign: 'キャンペーン',
+    adGroup: '広告グループ',
+    ad: '広告',
+};
+/** 人が目で確認するためのサマリを組み立てる。 */
+function formatStatusSummary(level, data) {
+    const lines = [];
+    const label = LEVEL_LABEL[level];
+    for (const t of data.targets ?? []) {
+        const parent = level === 'ad' ? ` (CP:${t.campaignId} AG:${t.adGroupId})`
+            : level === 'adGroup' ? ` (CP:${t.campaignId})`
+                : '';
+        const arrow = t.skipped
+            ? `${t.currentStatus} (変更なし)`
+            : `${t.currentStatus} → ${t.newStatus}`;
+        lines.push(`  ${t.id}  ${arrow}  ${t.name ?? ''}${parent}`);
+    }
+    for (const id of data.notFound ?? []) {
+        lines.push(`  ${id}  ✗ 見つかりません`);
+    }
+    for (const id of data.unusable ?? []) {
+        lines.push(`  ${id}  ✗ 親IDが解決できません`);
+    }
+    lines.push(`${label}: 指定 ${data.requested ?? 0} 件 / 解決 ${data.resolved ?? 0} 件 / ` +
+        `変更 ${data.willChange ?? 0} 件 / 変更不要 ${data.unchanged ?? 0} 件 / ` +
+        `未解決 ${(data.notFound?.length ?? 0) + (data.unusable?.length ?? 0)} 件`);
+    if (data.results) {
+        const failed = data.results.filter((r) => !r.ok);
+        lines.push(`結果: 成功 ${data.successCount ?? 0} 件 / 失敗 ${data.failureCount ?? 0} 件`);
+        for (const f of failed)
+            lines.push(`  ✗ ${f.id}: ${f.error ?? '不明なエラー'}`);
+    }
+    return lines.join('\n');
+}
+/**
+ * webgram update-status の本体。
+ *
+ * 安全弁 (submit / submit-plan と同思想):
+ *   1. dryRun=true (default) → ?dry_run=1 で POST。実 API を叩かず「現status → 新status」を返すだけ
+ *   2. dryRun=false AND yes=false → exit 2
+ *   3. status=ACTIVE の本実行は confirmActivate も必須 (配信開始・課金が発生する操作のため)
+ *   4. ids 上限 STATUS_MAX_IDS
+ */
+async function runUpdateStatus(input) {
+    const log = input.logger ?? ((line) => console.error(line));
+    if (!exports.STATUS_PLATFORMS.includes(input.platform)) {
+        return {
+            ok: false,
+            exitCode: 1,
+            error: `webgram update-status は ${input.platform} に未対応です (対応: ${exports.STATUS_PLATFORMS.join(', ')})`,
+        };
+    }
+    if (!exports.STATUS_LEVELS.includes(input.level)) {
+        return { ok: false, exitCode: 1, error: `unsupported level: ${input.level}` };
+    }
+    if (input.status !== 'ACTIVE' && input.status !== 'PAUSED') {
+        return { ok: false, exitCode: 1, error: `--status は ACTIVE か PAUSED です (指定: ${input.status})` };
+    }
+    if (!input.accountId) {
+        return { ok: false, exitCode: 1, error: '--account-id は必須です' };
+    }
+    // ID の収集 (--ids と --ids-file はマージする)
+    const rawParts = [];
+    if (input.ids)
+        rawParts.push(input.ids);
+    if (input.idsFile) {
+        try {
+            rawParts.push(fs_1.default.readFileSync(input.idsFile, 'utf8'));
+        }
+        catch (e) {
+            return { ok: false, exitCode: 1, error: `ids_file_read_error: ${e.message}` };
+        }
+    }
+    if (rawParts.length === 0) {
+        return { ok: false, exitCode: 1, error: '--ids か --ids-file のどちらかが必要です' };
+    }
+    const ids = parseIds(rawParts.join(','));
+    if (ids.length === 0) {
+        return { ok: false, exitCode: 1, error: '有効な ID がありません' };
+    }
+    if (ids.length > exports.STATUS_MAX_IDS) {
+        return {
+            ok: false,
+            exitCode: 1,
+            error: `ids は最大 ${exports.STATUS_MAX_IDS} 件までです (指定: ${ids.length} 件)`,
+        };
+    }
+    // 安全弁: 本実行には --yes、ACTIVE 化にはさらに --confirm-activate。
+    // dry-run を挟まずいきなり ACTIVE にできてしまうと、ON 漏れの逆 (誤 ON による
+    // 意図しない配信・課金) が起きる。
+    if (!input.dryRun && !input.yes) {
+        return {
+            ok: false,
+            exitCode: 2,
+            error: '本実行するには --yes を明示してください (dry-run なしで実 API を叩く操作です)',
+        };
+    }
+    if (!input.dryRun && input.status === 'ACTIVE' && !input.confirmActivate) {
+        return {
+            ok: false,
+            exitCode: 2,
+            error: 'ACTIVE 化 (配信開始) の本実行には --confirm-activate も必要です ' +
+                '(先に dry-run で対象を確認してください)',
+        };
+    }
+    let client;
+    try {
+        client = (input.clientFactory ?? apiClient_1.buildAuthedApiClient)(input.store);
+    }
+    catch (e) {
+        return { ok: false, exitCode: 1, error: e.message };
+    }
+    log(`[cli/update-status] platform=${input.platform} level=${input.level} ` +
+        `account=${input.accountId} status=${input.status} ids=${ids.length} dry_run=${input.dryRun}`);
+    try {
+        const params = {};
+        if (input.dryRun)
+            params.dry_run = '1';
+        const res = await client.post(`/api/submission/${input.platform}/status`, {
+            accountId: input.accountId,
+            level: input.level,
+            ids,
+            status: input.status,
+            ...(input.status === 'ACTIVE' && !input.dryRun ? { confirmActivate: true } : {}),
+        }, {
+            params,
+            // 200 件を数チャンクに割って媒体 API を順に叩くため、既定 15 秒では足りない
+            ...(input.dryRun ? {} : { timeout: apiClient_1.SUBMIT_TIMEOUT_MS }),
+        });
+        const data = res.data;
+        log(formatStatusSummary(input.level, data));
+        // 部分失敗は成功扱いにしない。exit 0 だと CI / スクリプトが握り潰す。
+        if (!input.dryRun && (data.failureCount ?? 0) > 0) {
+            return {
+                ok: false,
+                exitCode: 3,
+                data,
+                error: `${data.failureCount} 件の更新に失敗しました`,
+            };
+        }
+        return { ok: true, exitCode: 0, data };
+    }
+    catch (err) {
+        const status = err?.response?.status;
+        const data = err
+            ?.response?.data;
+        if (status === 401)
+            return { ok: false, exitCode: 1, error: 'unauthorized' };
+        // 未解決IDでの中断は「何が解決できなかったか」を出さないと直しようがない
+        if (data?.error === 'unresolved_ids') {
+            log(formatStatusSummary(input.level, data));
+        }
+        const msg = data?.message ?? (0, apiError_1.describeApiError)(err);
+        return { ok: false, exitCode: 1, error: msg };
+    }
+}
+//# sourceMappingURL=status.js.map

package/dist/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/commands/status.ts"],"names":[],"mappings":"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"}

package/dist/commands/submission.js

@@ -13,7 +13,9 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const apiClient_1 = require("../lib/apiClient");
 const localPath_1 = require("../lib/localPath");
+const googleImageMetadata_1 = require("../lib/googleImageMetadata");
 const submit_plan_1 = require("../schemas/submit-plan");
+const apiError_1 = require("../lib/apiError");
 exports.SUBMIT_PLATFORMS = ['meta', 'yda', 'google', 'smartnews', 'bytedance'];
 /** v5 §5.3: platform → submit エンドポイント (T-02 yda, T-03 google, T-04 smartnews, T-05 bytedance) */
 function resolveSubmitPath(platform) {
@@ -283,18 +285,28 @@ async function resolveYdaImages(client, body, jsonFile, log) {
 async function resolveGoogleImages(client, body, jsonFile, log) {
     const baseDir = path_1.default.dirname(path_1.default.resolve(jsonFile));
     const customerId = String(body?.customerId ?? '');
-    const uploadOne = async (relPath) => {
+    const uploadOne = async (relPath, purpose) => {
         const abs = (0, localPath_1.resolveLocalMediaPath)(relPath, baseDir, 'image');
         const buf = fs_1.default.readFileSync(abs);
         const fileName = path_1.default.basename(abs);
         const form = new FormData();
         form.append('customerId', customerId);
         form.append('image', new Blob([buf]), fileName);
+        if (purpose)
+            form.append('purpose', purpose);
         const res = await client.post('/api/submission/google/upload-image', form, { timeout: 120000 });
         const rn = res.data?.asset_resource_name;
         if (!rn)
             throw new Error(`upload-image が asset_resource_name を返しませんでした (${fileName})`);
         log(`[cli/submit] uploaded image ${fileName} → ${rn}`);
+        // 入稿できる範囲の指摘 (推奨サイズ超過など)。握り潰すと運用者が気づけない
+        for (const w of res.data?.warnings ?? [])
+            log(`[cli/submit] ⚠ ${w}`);
+        /* 作った asset は削除できない。どのファイルから何を作ったかを計画ファイルに
+           残しておかないと、アカウントJSONへの書き戻し (refs-import --from-plan) で
+           追えなくなる。 */
+        if (purpose === 'demand_gen_logo')
+            recordUploadedLogo(body, rn, relPath, fileName);
         return rn;
     };
     const fields = [
@@ -302,25 +314,69 @@ async function resolveGoogleImages(client, body, jsonFile, log) {
         ['squareMarketingImagePaths', 'squareMarketingImages'],
         ['logoImagePaths', 'logoImages'],
     ];
+    const resolveField = async (ad, pathField, assetField, purpose) => {
+        const paths = Array.isArray(ad?.[pathField]) ? ad[pathField] : [];
+        if (paths.length === 0)
+            return;
+        const uploaded = [];
+        for (const p of paths)
+            uploaded.push(await uploadOne(p, purpose));
+        ad[assetField] = [...(Array.isArray(ad[assetField]) ? ad[assetField] : []), ...uploaded];
+        // 消さないと計画ファイルの再実行で同じ画像をもう一度アップロードしてしまう
+        delete ad[pathField];
+    };
     for (const cp of body?.campaigns ?? []) {
         for (const ag of cp?.adGroups ?? []) {
             for (const ad of ag?.ads ?? []) {
-                if (ad?.type !== 'RESPONSIVE_DISPLAY_AD')
+                if (ad?.type === 'RESPONSIVE_DISPLAY_AD') {
+                    for (const [pathField, assetField] of fields) {
+                        await resolveField(ad, pathField, assetField);
+                    }
                     continue;
-                for (const [pathField, assetField] of fields) {
-                    const paths = Array.isArray(ad?.[pathField]) ? ad[pathField] : [];
-                    if (paths.length === 0)
-                        continue;
-                    const uploaded = [];
-                    for (const p of paths)
-                        uploaded.push(await uploadOne(p));
-                    ad[assetField] = [...(Array.isArray(ad[assetField]) ? ad[assetField] : []), ...uploaded];
-                    delete ad[pathField];
+                }
+                /* Demand Gen は**ロゴだけ**。マーケティング画像のローカルパス対応は
+                   別スコープで、ここで一緒に上げると意図しないアセットが増える。 */
+                if (ad?.type === 'DEMAND_GEN_MULTI_ASSET_AD') {
+                    await resolveField(ad, 'logoImagePaths', 'logoImages', 'demand_gen_logo');
                 }
             }
         }
     }
 }
+/**
+ * アップロードしたロゴを計画ファイルへ記録する。
+ *
+ * `refs-import --from-plan` がこれを読んでアカウントJSONの `refs.logos` へ入れる。
+ * CLI が入稿の途中でアカウントJSONを直接書かないのは、実クライアントの参照データを
+ * 誤って壊す経路を増やさないため（過去に上書きで飛ばした事例がある）。
+ */
+/**
+ * 1 キャンペーン分の記録を計画ファイル側へ集める。
+ *
+ * **Google のロゴ専用。** 重複判定を `resourceName` でしているため、他媒体
+ * (Meta の imageHash / YDA の mediaId / TikTok の videoId) をそのまま流すと
+ * 全件 undefined 同士になって 2 件目以降が落ちる。媒体を増やすときは
+ * キーの決め方から作り直す。
+ */
+function mergeUploadedGoogleLogos(plan, uploaded) {
+    const logos = uploaded?.google?.logos;
+    if (!Array.isArray(logos) || logos.length === 0)
+        return;
+    const dest = ((plan.uploadedAssets ??= {}).google ??= {}).logos ??= [];
+    for (const item of logos) {
+        if (dest.some((d) => d?.resourceName === item?.resourceName))
+            continue;
+        dest.push(item);
+    }
+}
+function recordUploadedLogo(body, resourceName, originalPath, fileName) {
+    const bucket = (body.uploadedAssets ??= {});
+    const google = (bucket.google ??= {});
+    const logos = (google.logos ??= []);
+    if (logos.some((l) => l?.resourceName === resourceName))
+        return;
+    logos.push({ resourceName, originalPath, fileName });
+}
 /**
  * TikTok のアップロード対象を 1 箇所で決める。
  *
@@ -478,16 +534,24 @@ function collectMediaRefs(platform, body) {
         return refs;
     }
     if (platform === 'google') {
-        const pathFields = ['marketingImagePaths', 'squareMarketingImagePaths', 'logoImagePaths'];
+        const displayPathFields = ['marketingImagePaths', 'squareMarketingImagePaths', 'logoImagePaths'];
         for (const cp of body?.campaigns ?? []) {
             for (const ag of cp?.adGroups ?? []) {
                 for (const ad of ag?.ads ?? []) {
-                    if (ad?.type !== 'RESPONSIVE_DISPLAY_AD')
+                    if (ad?.type === 'RESPONSIVE_DISPLAY_AD') {
+                        for (const f of displayPathFields) {
+                            const paths = Array.isArray(ad?.[f]) ? ad[f] : [];
+                            for (const p of paths)
+                                refs.push({ value: p, kind: 'image' });
+                        }
                         continue;
-                    for (const f of pathFields) {
-                        const paths = Array.isArray(ad?.[f]) ? ad[f] : [];
+                    }
+                    /* Demand Gen は**ロゴだけ**アップロードの対象にする。マーケティング画像の
+                       ローカルパス対応は別スコープで、ここに混ぜると意図せず上がってしまう。 */
+                    if (ad?.type === 'DEMAND_GEN_MULTI_ASSET_AD') {
+                        const paths = Array.isArray(ad?.logoImagePaths) ? ad.logoImagePaths : [];
                         for (const p of paths)
-                            refs.push({ value: p, kind: 'image' });
+                            refs.push({ value: p, kind: 'image', purpose: 'demand_gen_logo' });
                     }
                 }
             }
@@ -495,6 +559,39 @@ function collectMediaRefs(platform, body) {
     }
     return refs;
 }
+/**
+ * Demand Gen のロゴ指定が backend の受け入れ条件を満たすかを、**アップロードの前に**見る。
+ *
+ * backend の superRefine (either 必須 / 同時指定不可 / 合計5件) は入稿 POST の時点で効くが、
+ * CLI は**その前にアップロードを済ませてしまう**。同時指定や6件を CLI が素通りさせると、
+ * backend が 400 を返す頃には削除できない asset が作られている。同じ条件をここでも見る。
+ */
+function validateGoogleLogoSources(platform, body) {
+    if (platform !== 'google')
+        return [];
+    const errors = [];
+    for (const cp of body?.campaigns ?? []) {
+        for (const ag of cp?.adGroups ?? []) {
+            for (const ad of ag?.ads ?? []) {
+                if (ad?.type !== 'DEMAND_GEN_MULTI_ASSET_AD')
+                    continue;
+                const assets = Array.isArray(ad?.logoImages) ? ad.logoImages.length : 0;
+                const paths = Array.isArray(ad?.logoImagePaths) ? ad.logoImagePaths.length : 0;
+                const where = `広告「${ad?.adName ?? '(名前なし)'}」`;
+                if (assets === 0 && paths === 0) {
+                    errors.push(`${where}: ロゴが指定されていません (logoImages、または未登録なら logoImagePaths)`);
+                }
+                if (assets > 0 && paths > 0) {
+                    errors.push(`${where}: logoImages と logoImagePaths は同時に指定できません（二重にアセットを作ってしまいます）`);
+                }
+                if (assets + paths > 5) {
+                    errors.push(`${where}: ロゴは合計 5 件までです (received ${assets + paths})`);
+                }
+            }
+        }
+    }
+    return errors;
+}
 /**
  * ローカルメディアパスを **アップロード前に全件** 解決・検証する。
  *
@@ -508,12 +605,23 @@ function collectMediaRefs(platform, body) {
 function validateLocalMediaPaths(platform, body, baseFile) {
     const baseDir = path_1.default.dirname(path_1.default.resolve(baseFile));
     const errors = [];
+    errors.push(...validateGoogleLogoSources(platform, body));
     for (const ref of collectMediaRefs(platform, body)) {
+        let abs;
         try {
-            (0, localPath_1.resolveLocalMediaPath)(ref.value, baseDir, ref.kind);
+            abs = (0, localPath_1.resolveLocalMediaPath)(ref.value, baseDir, ref.kind);
         }
         catch (e) {
             errors.push(e.message);
+            continue;
+        }
+        /* Google Ads のアセットは削除できないので、要件違反はアップロードを1件も
+           始める前に落とす。存在確認と同じループで見るのは、5枚中3枚目で気づいて
+           2枚が本番に残る事態を避けるため。 */
+        if (ref.purpose === 'demand_gen_logo') {
+            const check = (0, googleImageMetadata_1.validateDemandGenLogoImage)(fs_1.default.readFileSync(abs), path_1.default.basename(abs));
+            if (!check.ok)
+                errors.push(...check.errors);
         }
     }
     return errors;
@@ -610,6 +718,14 @@ async function runSubmit(input) {
             return { ok: false, exitCode: 1, error: `image_upload_error: ${e.message}` };
         }
     }
+    /* Google は同名キャンペーンを拒否する。**アップロードより前に**止めないと、
+       CP を作れないのに削除できないアセットだけが残る（submit-plan 側と同じ理由）。 */
+    if (input.platform === 'google' && !input.dryRun) {
+        const b = body;
+        const dup = await preflightGoogleCampaignNames(client, String(b?.customerId ?? b?.accountId ?? ''), Array.isArray(b?.campaigns) ? b.campaigns : [], log);
+        if (dup)
+            return dup;
+    }
     // 本実行時のみ: Google ディスプレイ広告のローカル画像(*ImagePaths)を先に
     // アップロードして asset resource_name へ解決。dry-run では実 API を叩かない
     if (input.platform === 'google' && !input.dryRun) {
@@ -678,8 +794,7 @@ async function runSubmit(input) {
         }
         if (status === 401)
             return { ok: false, exitCode: 1, error: 'unauthorized' };
-        const msg = data?.error ?? err.message ?? 'network_error';
-        return { ok: false, exitCode: 1, error: msg };
+        return { ok: false, exitCode: 1, error: (0, apiError_1.describeApiError)(err) };
     }
 }
 /** submit-plan が対応する媒体 (プランナーがスキーマ駆動で書き出せる媒体)。 */
@@ -734,6 +849,78 @@ function collectTargetErrors(data) {
     }
     return out;
 }
+/**
+ * これから送る Google キャンペーン名が、アカウントの既存 CP と衝突しないかを確かめる。
+ *
+ * **本実行の最初に、素材のアップロードより前に行う。** Google は同名 CP を拒否するので、
+ * 後で気づくと「削除できないアセットだけ作られて CP は作れない」状態になる。
+ *
+ * 一覧が取得上限で切れていたら (`truncated`)、見えている範囲に無くても
+ * 「重複なし」とは断定できない。**それでも止めない** — 大きなアカウントでは常に
+ * 切れてしまい、機能が使えなくなる。警告を出して進め、隠れた重複は Google 側の
+ * エラー (CP 本体を作る前に落ちる) に任せる。
+ */
+async function preflightGoogleCampaignNames(client, accountId, pending, log) {
+    if (pending.length === 0)
+        return null;
+    const conflicts = [];
+    /* 計画の中での重複は API を必要としない。一覧の取得可否と切り離して先に見る
+       （取得に失敗したときに、ローカルで分かる不整合まで見逃してしまう）。 */
+    const seen = new Set();
+    for (const cp of pending) {
+        const name = String(cp?.name ?? '').trim();
+        if (!name)
+            continue;
+        const key = name.toLowerCase();
+        if (seen.has(key))
+            conflicts.push(`「${name}」がこの計画の中で重複しています`);
+        seen.add(key);
+    }
+    let existing = [];
+    let truncated = false;
+    let listed = true;
+    try {
+        const res = await client.get('/api/submission/google/campaigns', {
+            params: { accountId },
+        });
+        existing = res.data?.campaigns ?? [];
+        truncated = !!res.data?.truncated;
+    }
+    catch (e) {
+        /* 一覧を引けないことを入稿の中止理由にはしない。プランナーと backend にも
+           同じ判定があり、ここは「早く気づける」ための層なので落とさない。 */
+        log(`[cli/submit] ⚠ 既存キャンペーン名を確認できませんでした: ${e.message}`);
+        listed = false;
+    }
+    if (listed) {
+        const known = new Set();
+        for (const c of existing) {
+            const n = String(c?.name ?? '').trim();
+            if (n)
+                known.add(n.toLowerCase());
+        }
+        for (const cp of pending) {
+            const name = String(cp?.name ?? '').trim();
+            if (name && known.has(name.toLowerCase())) {
+                conflicts.push(`「${name}」はアカウントの既存キャンペーンと同名です`);
+            }
+        }
+    }
+    if (conflicts.length > 0) {
+        return {
+            ok: false,
+            exitCode: 1,
+            error: 'campaign_name_duplicate: Google は同名キャンペーンを拒否します\n  - '
+                + conflicts.join('\n  - ')
+                + '\n  計画ファイルのキャンペーン名を変えてから再実行してください',
+        };
+    }
+    if (truncated) {
+        log('[cli/submit] ⚠ 既存キャンペーンが取得上限を超えています。'
+            + '重複が無いことを確認しきれていません（一覧に無くても既存の可能性があります）');
+    }
+    return null;
+}
 /** 計画ファイルを現在の campaigns/progress で上書き保存する (再開の要)。 */
 function persistPlan(planFile, plan) {
     fs_1.default.writeFileSync(planFile, JSON.stringify(plan, null, 2), 'utf8');
@@ -822,6 +1009,20 @@ async function runSubmitPlan(input) {
      * すれば再開時に再アップロードしない。
      */
     const resolveMedia = async (singleBody) => {
+        try {
+            await resolveMediaInner(singleBody);
+        }
+        finally {
+            /* cp は plan.campaigns[i] と同一参照なので広告階層の解決結果は plan に載るが、
+               top-level の uploadedAssets は singleBody 側にしか付かない。
+      
+               **finally なのは、途中で失敗しても既に作った asset を記録するため。**
+               3枚中2枚目で落ちたとき、1枚目は Google に残る (asset は削除できない)。
+               記録を捨てると、その asset を追跡する手段が無くなる。 */
+            mergeUploadedGoogleLogos(plan, singleBody.uploadedAssets);
+        }
+    };
+    const resolveMediaInner = async (singleBody) => {
         if (platform === 'meta') {
             await resolveMetaVideos(client, singleBody, input.planFile, log);
             await resolveMetaImages(client, singleBody, input.planFile, log);
@@ -855,7 +1056,7 @@ async function runSubmitPlan(input) {
                 checks.push({ name: String(cp?.name ?? ''), ok: true });
             }
             catch (err) {
-                const msg = err?.response?.data?.error ?? err?.message ?? 'network_error';
+                const msg = (0, apiError_1.describeApiError)(err);
                 checks.push({ name: String(cp?.name ?? ''), ok: false, error: msg });
             }
         }
@@ -863,6 +1064,20 @@ async function runSubmitPlan(input) {
         log(`[cli/submit-plan] dry-run: ${checks.filter(c => c.ok).length}/${checks.length} OK`);
         return { ok: allOk, exitCode: allOk ? 0 : 1, data: { dry_run: true, checks } };
     }
+    /* Google は同名キャンペーンを拒否する。**ロゴのアップロードより前に**止めないと、
+       CP 作成で落ちる前に削除できないアセットを作ってしまう。
+       プランナーは refs のスナップショットしか見ないので、ここで実データと突き合わせる。 */
+    if (platform === 'google') {
+        /* 送らない CP は対象外。再開時に、既に入稿済みの CP 名で自分自身と
+           衝突していると誤検知してしまう。 */
+        const pending = plan.campaigns.filter((_, i) => {
+            const st = plan.progress?.[i]?.status;
+            return st !== 'submitted' && st !== 'unknown';
+        });
+        const dup = await preflightGoogleCampaignNames(client, plan.accountId, pending, log);
+        if (dup)
+            return dup;
+    }
     // ---- 本実行: 1 キャンペーンずつ入稿し、進捗を計画ファイルへ書き戻す ----
     const nowIso = input.nowIso ?? new Date().toISOString();
     for (let i = 0; i < plan.campaigns.length; i++) {
@@ -949,7 +1164,7 @@ async function runSubmitPlan(input) {
             }
         }
         catch (err) {
-            const msg = err?.response?.data?.error ?? err?.message ?? 'network_error';
+            const msg = (0, apiError_1.describeApiError)(err);
             // タイムアウト / 接続断は「失敗」ではなく「成否不明」。backend は入稿を続けており、
             // 実際にキャンペーンと広告が作成済みのことがある（実測あり）。failed にすると
             // 再実行で同じキャンペーンをもう一度作ってしまうので、unknown で止める。