siluzan-tso-cli 1.1.57 → 1.1.58-beta.2

package/dist/index.js

@@ -4049,7 +4049,7 @@ var DEFAULT_API_BASE;
 var init_defaults = __esm({
   "src/config/defaults.ts"() {
     "use strict";
-    DEFAULT_API_BASE = "https://tso-api.siluzan.com";
+    DEFAULT_API_BASE = "https://tso-api-ci.siluzan.com";
   }
 });
 
@@ -104889,18 +104889,68 @@ async function writeProgress(paths, progress) {
 function readProgress(paths) {
   return readJsonIfExists(paths.progressFile);
 }
-async function appendTaskLog(paths, entry) {
+function clampTaskLogEntry(entry) {
+  const message = entry.lastError;
+  if (!message || message.length <= MAX_TASK_LOG_ERROR_CHARS) return entry;
+  return {
+    ...entry,
+    lastError: `${message.slice(0, MAX_TASK_LOG_ERROR_CHARS)}\u2026(truncated)`
+  };
+}
+function isTaskLogEntry(value) {
+  if (!value || typeof value !== "object") return false;
+  const row = value;
+  return typeof row.at === "string" && typeof row.id === "string" && typeof row.accountId === "string" && typeof row.section === "string" && typeof row.state === "string" && TASK_LOG_STATES.has(row.state) && typeof row.attempts === "number";
+}
+async function writeTaskLogLine(paths, entry) {
   await fs31.mkdir(paths.stateDir, { recursive: true });
-  await fs31.appendFile(paths.tasksLogFile, JSON.stringify(entry) + "\n", "utf8");
+  await fs31.appendFile(paths.tasksLogFile, JSON.stringify(clampTaskLogEntry(entry)) + "\n", "utf8");
+}
+async function appendTaskLog(paths, entry) {
+  const file = paths.tasksLogFile;
+  const prev = taskLogAppendQueue.get(file) ?? Promise.resolve();
+  const current = prev.then(() => writeTaskLogLine(paths, entry));
+  taskLogAppendQueue.set(
+    file,
+    current.then(
+      () => void 0,
+      () => void 0
+    )
+  );
+  await current;
 }
 async function readTaskLog(paths) {
+  let raw;
   try {
-    const raw = await fs31.readFile(paths.tasksLogFile, "utf8");
-    return raw.split("\n").filter((s) => s.trim() !== "").map((line) => JSON.parse(line));
+    raw = await fs31.readFile(paths.tasksLogFile, "utf8");
   } catch (e) {
     if (e.code === "ENOENT") return [];
     throw e;
   }
+  const entries = [];
+  let skipped = 0;
+  for (const line of raw.split("\n")) {
+    const text2 = line.trim();
+    if (!text2) continue;
+    try {
+      const parsed = JSON.parse(text2);
+      if (!isTaskLogEntry(parsed)) {
+        skipped += 1;
+        continue;
+      }
+      entries.push(parsed);
+    } catch {
+      skipped += 1;
+    }
+  }
+  if (skipped > 0) {
+    process.stderr.write(
+      `
+\u26A0\uFE0F tasks.jsonl \u6709 ${skipped} \u884C\u65E0\u6CD5\u89E3\u6790\uFF0C\u5DF2\u8DF3\u8FC7\u3002\u6CA1\u6709\u5B8C\u6574\u6210\u529F\u8BB0\u5F55\u7684\u4EFB\u52A1\u4F1A\u5728 resume \u65F6\u91CD\u8DD1\u3002
+`
+    );
+  }
+  return entries;
 }
 function replayTaskStates(entries) {
   const map = /* @__PURE__ */ new Map();
@@ -104964,11 +105014,21 @@ async function tryAcquireLock(paths) {
 async function releaseLock(paths) {
   await fs31.rm(paths.lockFile, { force: true }).catch(() => void 0);
 }
-var BATCH_SCHEMA_VERSION;
+var BATCH_SCHEMA_VERSION, MAX_TASK_LOG_ERROR_CHARS, TASK_LOG_STATES, taskLogAppendQueue;
 var init_batch_manifest = __esm({
   "src/utils/batch-manifest.ts"() {
     "use strict";
     BATCH_SCHEMA_VERSION = 1;
+    MAX_TASK_LOG_ERROR_CHARS = 500;
+    TASK_LOG_STATES = /* @__PURE__ */ new Set([
+      "pending",
+      "running",
+      "success",
+      "failed_retryable",
+      "failed_permanent",
+      "skipped"
+    ]);
+    taskLogAppendQueue = /* @__PURE__ */ new Map();
   }
 });
 
@@ -113899,8 +113959,68 @@ init_cli_json_snapshot();
 init_strip_legacy_google_fields();
 init_cli_table();
 
+// src/commands/ad/search-field-patch.ts
+function buildSearchFieldPatch(pairs) {
+  const updateMask = [];
+  const fields = {};
+  for (const [name2, value] of pairs) {
+    updateMask.push(name2);
+    fields[name2] = value;
+  }
+  return { updateMask, fields };
+}
+function campaignEditPatchPairs(input) {
+  const pairs = [];
+  if (input.name !== void 0) pairs.push(["name", input.name]);
+  if (input.budgetCents !== void 0) pairs.push(["budgetAmount", input.budgetCents]);
+  if (input.biddingStrategyTypeV2 !== void 0) {
+    pairs.push(["biddingStrategyTypeV2", input.biddingStrategyTypeV2]);
+  }
+  if (input.targetSpendBidCeilingCents !== void 0) {
+    pairs.push(["targetSpend_BidCeilingAmount", input.targetSpendBidCeilingCents]);
+  }
+  if (input.targetCpaCents !== void 0) {
+    pairs.push(["targetCpa_BidingAmount", input.targetCpaCents]);
+  }
+  if (input.targetRoas !== void 0) pairs.push(["targetRoas", input.targetRoas]);
+  if (input.manualCpcEnhanced !== void 0) {
+    pairs.push(["manualCpc_EnhancedCpcEnabled", input.manualCpcEnhanced]);
+  }
+  return pairs;
+}
+function campaignStatusPatchPairs(status) {
+  return [["status", status]];
+}
+function adGroupEditPatchPairs(input) {
+  const pairs = [];
+  if (input.name !== void 0) pairs.push(["name", input.name]);
+  if (input.maxCpcCents !== void 0) pairs.push(["maxCpc", input.maxCpcCents]);
+  if (input.targetCpaCents !== void 0) pairs.push(["targetCpa", input.targetCpaCents]);
+  return pairs;
+}
+function adGroupStatusPatchPairs(status) {
+  return [["status", status]];
+}
+function keywordFieldPatchPairs(input) {
+  const pairs = [];
+  if (input.status !== void 0) pairs.push(["userStatus", input.status]);
+  if (input.maxCpcCents !== void 0) pairs.push(["maxCpc", input.maxCpcCents]);
+  if (input.finalUrl !== void 0) pairs.push(["finalUrl", input.finalUrl]);
+  return pairs;
+}
+function adEditPatchPairs(input) {
+  const pairs = [];
+  if (input.status !== void 0) pairs.push(["status", input.status]);
+  if (input.finalUrl !== void 0) pairs.push(["finalUrl", input.finalUrl]);
+  if (input.headlines !== void 0) pairs.push(["headlines", [...input.headlines]]);
+  if (input.descriptions !== void 0) pairs.push(["descriptions", [...input.descriptions]]);
+  if (input.path1 !== void 0) pairs.push(["path1", input.path1]);
+  if (input.path2 !== void 0) pairs.push(["path2", input.path2]);
+  return pairs;
+}
+
 // src/commands/ad/write-verification.ts
-var CAMPAIGN_WRITE_SCOPE = "gateway-full-put";
+var CAMPAIGN_WRITE_SCOPE = "search-field-patch";
 function sameWriteValue(expected, actual) {
   if (expected === actual) return true;
   if (typeof expected === "string" && typeof actual === "string") {
@@ -114537,71 +114657,91 @@ async function runAdKeywordEdit(opts) {
     );
     process.exit(1);
   }
+  const patchPairs = keywordFieldPatchPairs({
+    status: opts.status,
+    maxCpcCents: opts.maxCpc !== void 0 ? toCentAmount(opts.maxCpc) : void 0,
+    finalUrl: opts.finalUrl
+  });
+  const replacesText = opts.text !== void 0 || opts.matchType !== void 0;
   const params = new URLSearchParams();
   params.set("startDate", toGoogleDate(opts.startDate, -30));
   params.set("endDate", toGoogleDate(opts.endDate, 0));
   const listUrl = `${googleApiUrl}/keywordmanagement/v2/list/${opts.account}?${params}`;
-  let keyword;
-  try {
-    keyword = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const body = { ...keyword };
-  if (opts.matchType !== void 0) {
-    const base = opts.text !== void 0 ? opts.text : firstKeywordTextFromRecord(keyword);
-    if (!String(base).trim()) {
-      console.error("\n\u274C \u65E0\u6CD5\u89E3\u6790\u5F53\u524D\u5173\u952E\u8BCD\u6587\u6848\uFF0C\u8BF7\u540C\u65F6\u4F20 --text <\u8BCD\u5E72>\n");
-      process.exit(1);
-    }
-    body["keywordText"] = [formatKeywordTextForMatchType(base, opts.matchType)];
-    body["matchTypeV2"] = opts.matchType;
-  } else if (opts.text !== void 0) {
-    body["keywordText"] = [opts.text];
-  }
-  if (opts.maxCpc !== void 0) body["maxCPC"] = toCentAmount(opts.maxCpc);
-  if (opts.finalUrl !== void 0) body["finalURL"] = opts.finalUrl;
-  if (opts.status !== void 0) body["userStatusV2"] = opts.status;
   const notAppliedHint = `   \u8BF7\u52FF\u6539\u7528\u300C\u5220\u9664\u540E\u91CD\u5EFA\u300D\u7ED5\u8FC7\uFF08\u4F1A\u4E22\u5931\u5173\u952E\u8BCD id \u4E0E\u5386\u53F2\u6570\u636E\uFF09\uFF0C\u8BF7\u53CD\u9988\u5E73\u53F0\u6392\u67E5\u3002
 `;
-  const url = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/batch`;
   let currentId = opts.id;
-  try {
-    const raw = await apiFetch2(
-      url,
-      config,
-      { method: "PUT", body: JSON.stringify([body]) },
-      opts.verbose
-    );
-    const first = Array.isArray(raw) && raw.length > 0 && raw[0] && typeof raw[0] === "object" ? raw[0] : null;
-    const returnedId = first && typeof first["id"] === "string" ? first["id"] : void 0;
-    if (returnedId && returnedId !== opts.id) {
-      currentId = returnedId;
-      console.log(
-        `
-\u2139\uFE0F \u7F51\u5173\u8FD4\u56DE\u7684\u5173\u952E\u8BCD id \u5DF2\u53D8\u66F4\u4E3A ${returnedId}\uFF08\u8BF7\u6C42\u65F6 id \u4E3A ${opts.id}\uFF0CchangeKind=replace\uFF09\uFF0C\u540E\u7EED\u67E5\u8BE2\u8BF7\u4F7F\u7528\u65B0 id\u3002
-`
+  if (replacesText) {
+    let keyword;
+    try {
+      keyword = await findItemInList(
+        listUrl,
+        config,
+        opts.id,
+        opts.verbose
       );
+    } catch (err) {
+      console.error(`
+\u274C \u67E5\u8BE2\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
+      process.exit(1);
     }
-    const mismatches = first ? findKeywordEditMismatches(body, first, opts) : [];
-    if (mismatches.length > 0) {
-      console.error(
-        `
-\u274C \u7F51\u5173\u8FD4\u56DE\u6210\u529F\uFF0C\u4F46\u4EE5\u4E0B\u5B57\u6BB5\u672A\u751F\u6548\uFF1A
-${mismatches.map((m) => `   - ${m}`).join("\n")}
-` + notAppliedHint
+    const body = { ...keyword };
+    if (opts.matchType !== void 0) {
+      const base = opts.text !== void 0 ? opts.text : firstKeywordTextFromRecord(keyword);
+      if (!String(base).trim()) {
+        console.error("\n\u274C \u65E0\u6CD5\u89E3\u6790\u5F53\u524D\u5173\u952E\u8BCD\u6587\u6848\uFF0C\u8BF7\u540C\u65F6\u4F20 --text <\u8BCD\u5E72>\n");
+        process.exit(1);
+      }
+      body["keywordText"] = [formatKeywordTextForMatchType(base, opts.matchType)];
+      body["matchTypeV2"] = opts.matchType;
+    } else if (opts.text !== void 0) {
+      body["keywordText"] = [opts.text];
+    }
+    const url = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/batch`;
+    try {
+      const raw = await apiFetch2(
+        url,
+        config,
+        { method: "PUT", body: JSON.stringify([body]) },
+        opts.verbose
       );
+      const first = Array.isArray(raw) && raw.length > 0 && raw[0] && typeof raw[0] === "object" ? raw[0] : null;
+      const returnedId = first && typeof first["id"] === "string" ? first["id"] : void 0;
+      if (returnedId && returnedId !== opts.id) {
+        currentId = returnedId;
+        console.log(
+          `
+\u2139\uFE0F \u7F51\u5173\u8FD4\u56DE\u7684\u5173\u952E\u8BCD id \u5DF2\u53D8\u66F4\u4E3A ${returnedId}\uFF08\u8BF7\u6C42\u65F6 id \u4E3A ${opts.id}\uFF0CchangeKind=replace\uFF09\uFF0C\u540E\u7EED\u67E5\u8BE2\u8BF7\u4F7F\u7528\u65B0 id\u3002
+`
+        );
+      }
+    } catch (err) {
+      console.error(`
+\u274C \u7F16\u8F91\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+`);
       process.exit(1);
     }
-  } catch (err) {
-    console.error(`
+  }
+  if (patchPairs.length > 0) {
+    const patchUrl = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/${currentId}`;
+    try {
+      await apiFetch2(
+        patchUrl,
+        config,
+        { method: "PATCH", body: JSON.stringify(buildSearchFieldPatch(patchPairs)) },
+        opts.verbose
+      );
+    } catch (err) {
+      console.error(`
 \u274C \u7F16\u8F91\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
 `);
-    process.exit(1);
+      process.exit(1);
+    }
   }
+  const readbackExpected = {
+    finalURL: opts.finalUrl,
+    maxCPC: opts.maxCpc !== void 0 ? toCentAmount(opts.maxCpc) : void 0
+  };
   if (opts.finalUrl !== void 0 || opts.maxCpc !== void 0 || opts.status !== void 0) {
     let fresh;
     try {
@@ -114620,7 +114760,7 @@ ${mismatches.map((m) => `   - ${m}`).join("\n")}
       );
       process.exit(1);
     }
-    const mismatches = findKeywordEditMismatches(body, fresh, opts);
+    const mismatches = findKeywordEditMismatches(readbackExpected, fresh, opts);
     if (mismatches.length > 0) {
       console.error(
         `
@@ -114658,26 +114798,17 @@ async function runAdKeywordStatus(opts) {
   opts = withResolvedAdAccount(opts);
   const config = await ensureDataPermission(loadConfig(opts.token));
   const googleApiUrl = requireGoogleApi(config);
-  const params = new URLSearchParams();
-  params.set("startDate", toGoogleDate(opts.startDate, -30));
-  params.set("endDate", toGoogleDate(opts.endDate, 0));
-  const listUrl = `${googleApiUrl}/keywordmanagement/v2/list/${opts.account}?${params}`;
-  let keyword;
-  try {
-    keyword = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5173\u952E\u8BCD\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const body = { ...keyword, userStatusV2: opts.status };
-  const url = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/batch`;
+  const url = `${googleApiUrl}/keywordmanagement/Keyword/${opts.account}/${opts.id}`;
   try {
     await apiFetch2(
       url,
       config,
-      { method: "PUT", body: JSON.stringify([body]) },
+      {
+        method: "PATCH",
+        body: JSON.stringify(
+          buildSearchFieldPatch(keywordFieldPatchPairs({ status: opts.status }))
+        )
+      },
       opts.verbose
     );
   } catch (err) {
@@ -116331,7 +116462,7 @@ async function reportFailedCampaignPut(opts) {
 `);
     process.exit(1);
   }
-  const hint = judged.kind === "partial" ? "\u56DE\u8BFB\u9884\u7B97\u5DF2\u76F8\u5BF9\u63D0\u4EA4\u524D\u53D8\u5316\u3002\u9884\u7B97\u53EF\u80FD\u5DF2\u5199\u5165\uFF0C\u7CFB\u5217\u5176\u4F59\u66F4\u65B0\u672A\u5B8C\u6210\u3002\u4E0D\u8981\u6574\u5305\u91CD\u63D0\u3002" : "\u56DE\u8BFB\u5931\u8D25\u6216\u65E0\u6CD5\u5BF9\u6BD4\u9884\u7B97\uFF0C\u5199\u5165\u7ED3\u679C\u672A\u77E5\u3002\u4E0D\u8981\u6574\u5305\u91CD\u63D0\u3002";
+  const hint = judged.kind === "partial" ? "\u56DE\u8BFB\u9884\u7B97\u5DF2\u76F8\u5BF9\u63D0\u4EA4\u524D\u53D8\u5316\u3002\u9884\u7B97\u53EF\u80FD\u5DF2\u5199\u5165\uFF0C\u5176\u4F59\u66F4\u65B0\u672A\u5B8C\u6210\u3002\u4E0D\u8981\u7ACB\u523B\u91CD\u53D1\u3002" : "\u56DE\u8BFB\u5931\u8D25\u6216\u65E0\u6CD5\u5BF9\u6BD4\u9884\u7B97\uFF0C\u5199\u5165\u7ED3\u679C\u672A\u77E5\u3002\u4E0D\u8981\u7ACB\u523B\u91CD\u53D1\u3002";
   await reportCampaignWrite({
     jsonOut: opts.jsonOut,
     account: opts.account,
@@ -116403,9 +116534,14 @@ async function runAdCampaignStatus(opts) {
     );
     process.exit(1);
   }
-  const body = { ...campaign, statusV2: opts.status };
+  const body = buildSearchFieldPatch(campaignStatusPatchPairs(opts.status));
   try {
-    await apiFetch2(detailUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
+    await apiFetch2(
+      detailUrl,
+      config,
+      { method: "PATCH", body: JSON.stringify(body) },
+      opts.verbose
+    );
   } catch (err) {
     await reportFailedCampaignPut({
       err,
@@ -116721,24 +116857,17 @@ async function runAdCampaignEdit(opts) {
     );
     process.exit(1);
   }
-  const body = { ...campaign };
-  if (opts.name !== void 0) body["name"] = opts.name;
-  if (opts.budget !== void 0) body["budget"] = toCentAmount(opts.budget);
-  if (opts.biddingStrategy !== void 0) {
-    body["biddingStrategyTypeV2"] = opts.biddingStrategy.toUpperCase();
-  }
-  if (opts.targetSpendBidCeiling !== void 0)
-    body["targetSpend_BidCeilingAmount"] = toCentAmount(opts.targetSpendBidCeiling);
-  if (opts.targetCpa !== void 0) body["targetCpa_BidingAmount"] = toCentAmount(opts.targetCpa);
-  if (opts.targetRoas !== void 0) body["targetRoas"] = opts.targetRoas;
-  if (opts.manualCpcEnhanced !== void 0)
-    body["manualCpc_EnhancedCpcEnabled"] = opts.manualCpcEnhanced;
-  if (opts.targetSearchNetwork !== void 0)
-    body["targetSearchNetwork"] = opts.targetSearchNetwork;
-  if (opts.targetContentNetwork !== void 0)
-    body["targetContentNetwork"] = opts.targetContentNetwork;
-  const hasChange = opts.name !== void 0 || opts.budget !== void 0 || opts.biddingStrategy !== void 0 || opts.targetSpendBidCeiling !== void 0 || opts.targetCpa !== void 0 || opts.targetRoas !== void 0 || opts.manualCpcEnhanced !== void 0 || opts.targetSearchNetwork !== void 0 || opts.targetContentNetwork !== void 0;
-  if (!hasChange) {
+  const patchPairs = campaignEditPatchPairs({
+    name: opts.name,
+    budgetCents: opts.budget !== void 0 ? toCentAmount(opts.budget) : void 0,
+    biddingStrategyTypeV2: opts.biddingStrategy?.toUpperCase(),
+    targetSpendBidCeilingCents: opts.targetSpendBidCeiling !== void 0 ? toCentAmount(opts.targetSpendBidCeiling) : void 0,
+    targetCpaCents: opts.targetCpa !== void 0 ? toCentAmount(opts.targetCpa) : void 0,
+    targetRoas: opts.targetRoas,
+    manualCpcEnhanced: opts.manualCpcEnhanced
+  });
+  const wantsNetwork = opts.targetSearchNetwork !== void 0 || opts.targetContentNetwork !== void 0;
+  if (patchPairs.length === 0 && !wantsNetwork) {
     console.error("\n\u274C \u8BF7\u81F3\u5C11\u6307\u5B9A\u4E00\u4E2A\u4FEE\u6539\u9879\uFF08--name / --budget / --bidding / \u2026\uFF09\n");
     process.exit(1);
   }
@@ -116748,23 +116877,66 @@ async function runAdCampaignEdit(opts) {
     );
     process.exit(1);
   }
-  try {
-    await apiFetch2(detailUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
-  } catch (err) {
-    await reportFailedCampaignPut({
-      err,
-      detailUrl,
-      config,
-      verbose: opts.verbose,
-      budgetCentsBefore: readCampaignBudgetCents(campaign),
-      jsonOut: opts.jsonOut,
-      account: opts.account,
-      id: opts.id,
-      section: "ad-campaign-edit",
-      commandLabel: "ad campaign-edit",
-      failureLabel: "\u7F16\u8F91\u5E7F\u544A\u7CFB\u5217\u5931\u8D25"
-    });
-    return;
+  if (patchPairs.length > 0) {
+    try {
+      await apiFetch2(
+        detailUrl,
+        config,
+        {
+          method: "PATCH",
+          body: JSON.stringify(buildSearchFieldPatch(patchPairs))
+        },
+        opts.verbose
+      );
+    } catch (err) {
+      await reportFailedCampaignPut({
+        err,
+        detailUrl,
+        config,
+        verbose: opts.verbose,
+        budgetCentsBefore: readCampaignBudgetCents(campaign),
+        jsonOut: opts.jsonOut,
+        account: opts.account,
+        id: opts.id,
+        section: "ad-campaign-edit",
+        commandLabel: "ad campaign-edit",
+        failureLabel: "\u7F16\u8F91\u5E7F\u544A\u7CFB\u5217\u5931\u8D25"
+      });
+      return;
+    }
+  }
+  if (wantsNetwork) {
+    try {
+      const fresh = await fetchCampaignRecord(detailUrl, config, opts.verbose);
+      const networkBody = { ...fresh };
+      if (opts.targetSearchNetwork !== void 0) {
+        networkBody["targetSearchNetwork"] = opts.targetSearchNetwork;
+      }
+      if (opts.targetContentNetwork !== void 0) {
+        networkBody["targetContentNetwork"] = opts.targetContentNetwork;
+      }
+      await apiFetch2(
+        detailUrl,
+        config,
+        { method: "PUT", body: JSON.stringify(networkBody) },
+        opts.verbose
+      );
+    } catch (err) {
+      await reportFailedCampaignPut({
+        err,
+        detailUrl,
+        config,
+        verbose: opts.verbose,
+        budgetCentsBefore: readCampaignBudgetCents(campaign),
+        jsonOut: opts.jsonOut,
+        account: opts.account,
+        id: opts.id,
+        section: "ad-campaign-edit",
+        commandLabel: "ad campaign-edit",
+        failureLabel: "\u7F16\u8F91\u5E7F\u544A\u7CFB\u5217\u5931\u8D25"
+      });
+      return;
+    }
   }
   const parts = [];
   if (opts.name !== void 0) parts.push(`\u540D\u79F0\u2192${opts.name}`);
@@ -116954,26 +117126,15 @@ async function runAdGroupStatus(opts) {
   opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const listUrl = adgroupListUrl(googleApiUrl, opts.account, opts.startDate, opts.endDate);
-  let adgroup;
-  try {
-    adgroup = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5E7F\u544A\u7EC4\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const putUrl = `${googleApiUrl}/adgroupnmanagement/adgroup/${opts.account}/${opts.id}`;
-  const body = { ...adgroup, statusV2: opts.status };
-  try {
-    await apiFetch2(putUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u72B6\u6001\u66F4\u65B0\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
+  await patchAdGroup(
+    googleApiUrl,
+    config,
+    opts.account,
+    opts.id,
+    adGroupStatusPatchPairs(opts.status),
+    opts.verbose,
+    "\u72B6\u6001\u66F4\u65B0\u5931\u8D25"
+  );
   console.log(`
 \u2705 \u5E7F\u544A\u7EC4 ${opts.id} \u5DF2\u8BBE\u7F6E\u4E3A ${opts.status}
 `);
@@ -117009,26 +117170,15 @@ async function runAdGroupRename(opts) {
   opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const listUrl = adgroupListUrl(googleApiUrl, opts.account, opts.startDate, opts.endDate);
-  let adgroup;
-  try {
-    adgroup = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5E7F\u544A\u7EC4\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const putUrl = `${googleApiUrl}/adgroupnmanagement/adgroup/${opts.account}/${opts.id}`;
-  const body = { ...adgroup, name: opts.name };
-  try {
-    await apiFetch2(putUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u6539\u540D\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
+  await patchAdGroup(
+    googleApiUrl,
+    config,
+    opts.account,
+    opts.id,
+    adGroupEditPatchPairs({ name: opts.name }),
+    opts.verbose,
+    "\u6539\u540D\u5931\u8D25"
+  );
   console.log(`
 \u2705 \u5E7F\u544A\u7EC4 ${opts.id} \u5DF2\u6539\u540D\u4E3A\u300C${opts.name}\u300D
 `);
@@ -117052,32 +117202,38 @@ async function runAdGroupEdit(opts) {
   }
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const listUrl = adgroupListUrl(googleApiUrl, opts.account, opts.startDate, opts.endDate);
-  let adgroup;
-  try {
-    adgroup = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5E7F\u544A\u7EC4\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+  await patchAdGroup(
+    googleApiUrl,
+    config,
+    opts.account,
+    opts.id,
+    adGroupEditPatchPairs({
+      name: hasName ? opts.name.trim() : void 0,
+      maxCpcCents: hasMax ? toCentAmount(opts.maxCPCAmount) : void 0,
+      targetCpaCents: hasTcpa ? toCentAmount(opts.targetCpaAmount) : void 0
+    }),
+    opts.verbose,
+    "\u7F16\u8F91\u5E7F\u544A\u7EC4\u5931\u8D25"
+  );
+  console.log(`
+\u2705 \u5E7F\u544A\u7EC4 ${opts.id} \u5DF2\u66F4\u65B0
 `);
-    process.exit(1);
-  }
-  const body = { ...adgroup };
-  if (hasName) body["name"] = opts.name.trim();
-  if (hasMax) body["maxCPCAmount"] = toCentAmount(opts.maxCPCAmount);
-  if (hasTcpa) body["targetCpaAmount"] = toCentAmount(opts.targetCpaAmount);
-  const putUrl = `${googleApiUrl}/adgroupnmanagement/adgroup/${opts.account}/${opts.id}`;
+}
+async function patchAdGroup(googleApiUrl, config, account, id, pairs, verbose, failureLabel) {
+  const url = `${googleApiUrl}/adgroupnmanagement/adgroup/${account}/${id}`;
   try {
-    await apiFetch2(putUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
+    await apiFetch2(
+      url,
+      config,
+      { method: "PATCH", body: JSON.stringify(buildSearchFieldPatch(pairs)) },
+      verbose
+    );
   } catch (err) {
     console.error(`
-\u274C \u7F16\u8F91\u5E7F\u544A\u7EC4\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
+\u274C ${failureLabel}\uFF1A${err instanceof Error ? err.message : String(err)}
 `);
     process.exit(1);
   }
-  console.log(`
-\u2705 \u5E7F\u544A\u7EC4 ${opts.id} \u5DF2\u66F4\u65B0
-`);
 }
 
 // src/commands/ad/ad-creative.ts
@@ -117304,23 +117460,17 @@ async function runAdStatus(opts) {
   opts = withResolvedAdAccount(opts);
   const config = loadConfig(opts.token);
   const googleApiUrl = requireGoogleApi(config);
-  const params = new URLSearchParams();
-  params.set("startDate", toGoogleDate(opts.startDate, -30));
-  params.set("endDate", toGoogleDate(opts.endDate, 0));
-  const listUrl = `${googleApiUrl}/admanagement/v2/list/${opts.account}?${params}`;
-  let ad;
-  try {
-    ad = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5E7F\u544A\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const putUrl = `${googleApiUrl}/admanagement/campaign/${opts.account}/${opts.id}`;
-  const body = { ...ad, statusV2: opts.status };
+  const url = `${googleApiUrl}/admanagement/campaign/${opts.account}/${opts.id}`;
   try {
-    await apiFetch2(putUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
+    await apiFetch2(
+      url,
+      config,
+      {
+        method: "PATCH",
+        body: JSON.stringify(buildSearchFieldPatch(adEditPatchPairs({ status: opts.status })))
+      },
+      opts.verbose
+    );
   } catch (err) {
     console.error(`
 \u274C \u72B6\u6001\u66F4\u65B0\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
@@ -117361,6 +117511,11 @@ async function runAdDelete(opts) {
 \u2705 \u5E7F\u544A ${opts.id} \u5DF2\u5220\u9664
 `);
 }
+function emptyPathClears(value) {
+  if (value === void 0) return void 0;
+  const trimmed = value.trim();
+  return trimmed === "" ? null : trimmed;
+}
 async function runAdEdit(opts) {
   opts = withResolvedAdAccount(opts);
   const config = await ensureDataPermission(loadConfig(opts.token));
@@ -117382,40 +117537,19 @@ async function runAdEdit(opts) {
     console.error(formatRsaCliValidationError(rsaErrors));
     process.exit(1);
   }
-  const params = new URLSearchParams();
-  params.set("startDate", toGoogleDate(opts.startDate, -30));
-  params.set("endDate", toGoogleDate(opts.endDate, 0));
-  const listUrl = `${googleApiUrl}/admanagement/v2/list/${opts.account}?${params}`;
-  let ad;
-  try {
-    ad = await findItemInList(listUrl, config, opts.id, opts.verbose);
-  } catch (err) {
-    console.error(`
-\u274C \u67E5\u8BE2\u5E7F\u544A\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
-`);
-    process.exit(1);
-  }
-  const body = { ...ad };
-  if (opts.headlines) {
-    const [h1, h2, h3, ...more] = opts.headlines;
-    body["headlinePart1"] = h1;
-    body["headlinePart2"] = h2;
-    body["headlinePart3"] = h3;
-    if (more.length > 0) body["AddtionalHeadlines"] = more;
-  }
-  if (opts.descriptions) {
-    const [d1, d2, ...more] = opts.descriptions;
-    body["adDescription"] = d1;
-    body["adDescription2"] = d2;
-    if (more.length > 0) body["AddtionalAdDescriptions"] = more;
-  }
-  if (opts.finalUrl !== void 0) body["finalUrl"] = opts.finalUrl;
-  if (opts.path1 !== void 0) body["path1"] = opts.path1;
-  if (opts.path2 !== void 0) body["path2"] = opts.path2;
-  if (opts.status !== void 0) body["statusV2"] = opts.status;
-  const putUrl = `${googleApiUrl}/admanagement/campaign/${opts.account}/${opts.id}`;
+  const url = `${googleApiUrl}/admanagement/campaign/${opts.account}/${opts.id}`;
+  const body = buildSearchFieldPatch(
+    adEditPatchPairs({
+      status: opts.status,
+      finalUrl: opts.finalUrl,
+      headlines: opts.headlines,
+      descriptions: opts.descriptions,
+      path1: emptyPathClears(opts.path1),
+      path2: emptyPathClears(opts.path2)
+    })
+  );
   try {
-    await apiFetch2(putUrl, config, { method: "PUT", body: JSON.stringify(body) }, opts.verbose);
+    await apiFetch2(url, config, { method: "PATCH", body: JSON.stringify(body) }, opts.verbose);
   } catch (err) {
     console.error(`
 \u274C \u7F16\u8F91\u5E7F\u544A\u5931\u8D25\uFF1A${err instanceof Error ? err.message : String(err)}
@@ -124642,7 +124776,7 @@ function register21(program2) {
       });
     }
   );
-  adCmd.command("campaign-status").description("\u5207\u6362\u5E7F\u544A\u7CFB\u5217\u72B6\u6001\uFF08Enabled / Paused\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <campaignId>", "\u5E7F\u544A\u7CFB\u5217 ID").requiredOption("--status <status>", "\u76EE\u6807\u72B6\u6001\uFF1AEnabled | Paused").option("--json-out <path>", "\u843D\u76D8\u6838\u9A8C\u7ED3\u679C\uFF08writeScope=gateway-full-put\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  adCmd.command("campaign-status").description("\u5207\u6362\u5E7F\u544A\u7CFB\u5217\u72B6\u6001\uFF08Enabled / Paused\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <campaignId>", "\u5E7F\u544A\u7CFB\u5217 ID").requiredOption("--status <status>", "\u76EE\u6807\u72B6\u6001\uFF1AEnabled | Paused").option("--json-out <path>", "\u843D\u76D8\u6838\u9A8C\u7ED3\u679C\uFF08writeScope=search-field-patch\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       if (opts.status !== "Enabled" && opts.status !== "Paused") {
         console.error("\n\u274C --status \u53EA\u63A5\u53D7 Enabled \u6216 Paused\n");
@@ -125148,7 +125282,9 @@ function register21(program2) {
       verbose: opts.verbose
     });
   });
-  adCmd.command("campaign-edit").description("\u7F16\u8F91\u5E7F\u544A\u7CFB\u5217\uFF08\u540D\u79F0/\u9884\u7B97/\u51FA\u4EF7\u7B56\u7565/\u6295\u653E\u7F51\u7EDC\uFF0C\u81F3\u5C11\u4F20\u4E00\u4E2A\u4FEE\u6539\u9879\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <campaignId>", "\u5E7F\u544A\u7CFB\u5217 ID").option("--name <name>", "\u65B0\u540D\u79F0").option(
+  adCmd.command("campaign-edit").description(
+    "\u7F16\u8F91\u641C\u7D22\u5E7F\u544A\u7CFB\u5217\u3002\u540D\u79F0/\u9884\u7B97/\u51FA\u4EF7\u8D70\u5B57\u6BB5\u7EA7 PATCH\uFF1B\u6295\u653E\u7F51\u7EDC\u4ECD\u7528\u6574\u5305 PUT\u3002\u81F3\u5C11\u4F20\u4E00\u4E2A\u4FEE\u6539\u9879"
+  ).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <campaignId>", "\u5E7F\u544A\u7CFB\u5217 ID").option("--name <name>", "\u65B0\u540D\u79F0").option(
     "--budget <amount>",
     "\u65B0\u9884\u7B97\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 100 \u8868\u793A \xA5100\uFF1B\u652F\u6301\u5C0F\u6570\uFF1BCLI \u5185\u90E8\u81EA\u52A8 \xD7100 \u5199\u5165\u300C\u5206\u300D\u5B57\u6BB5\uFF09",
     parseFloat
@@ -125171,7 +125307,7 @@ function register21(program2) {
     "--search-network <bool>",
     "\u6295\u653E\u5230 Google \u641C\u7D22\uFF1Atrue | false",
     (v) => v === "true"
-  ).option("--content-network <bool>", "\u6295\u653E\u5230\u5C55\u793A\u7F51\u7EDC\uFF1Atrue | false", (v) => v === "true").option("--json-out <path>", "\u843D\u76D8\u6838\u9A8C\u7ED3\u679C\uFF08writeScope=gateway-full-put\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  ).option("--content-network <bool>", "\u6295\u653E\u5230\u5C55\u793A\u7F51\u7EDC\uFF1Atrue | false", (v) => v === "true").option("--json-out <path>", "\u843D\u76D8\u6838\u9A8C\u7ED3\u679C\uFF08writeScope=search-field-patch\uFF09").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       await runAdCampaignEdit({
         token: opts.token,
@@ -125204,7 +125340,7 @@ function register21(program2) {
       });
     }
   );
-  adCmd.command("adgroup-edit").description("\u7F16\u8F91\u5E7F\u544A\u7EC4\uFF08\u540D\u79F0\u3001\u6700\u9AD8 CPC\u3001\u7EC4\u7EA7\u76EE\u6807 CPA\uFF1B\u81F3\u5C11\u4F20\u4E00\u9879\uFF1B\u4E0E\u7F51\u5173 PUT \u4E00\u81F4\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <adgroupId>", "\u5E7F\u544A\u7EC4 ID").option("--name <name>", "\u65B0\u540D\u79F0").option(
+  adCmd.command("adgroup-edit").description("\u7F16\u8F91\u641C\u7D22\u5E7F\u544A\u7EC4\uFF08\u540D\u79F0\u3001\u6700\u9AD8 CPC\u3001\u7EC4\u7EA7\u76EE\u6807 CPA\uFF1B\u81F3\u5C11\u4F20\u4E00\u9879\uFF1B\u5B57\u6BB5\u7EA7 PATCH\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <adgroupId>", "\u5E7F\u544A\u7EC4 ID").option("--name <name>", "\u65B0\u540D\u79F0").option(
     "--max-cpc <n>",
     "\u6700\u9AD8 CPC\uFF0C\u4E3B\u5E01\u79CD\u91D1\u989D\uFF08\u5982 1.5 \u8868\u793A \xA51.50\uFF1BCLI \u5185\u90E8 \xD7100 \u5199\u5165\u300C\u5206\u300D\u5B57\u6BB5\uFF09",
     parseFloat
@@ -125228,7 +125364,7 @@ function register21(program2) {
     }
   );
   adCmd.command("ad-edit").description(
-    "\u7F16\u8F91\u81EA\u9002\u5E94\u641C\u7D22\u5E7F\u544A\uFF08RESPONSIVE_SEARCH_AD\uFF09\uFF1A\u6807\u9898/\u63CF\u8FF0/\u843D\u5730\u9875/\u8DEF\u5F84/\u72B6\u6001\uFF1B\u4E0E\u7F51\u9875 PUT admanagement/campaign \u884C\u4E3A\u4E00\u81F4"
+    "\u7F16\u8F91\u81EA\u9002\u5E94\u641C\u7D22\u5E7F\u544A\uFF08RESPONSIVE_SEARCH_AD\uFF09\uFF1A\u6807\u9898/\u63CF\u8FF0/\u843D\u5730\u9875/\u8DEF\u5F84/\u72B6\u6001\uFF1B\u5B57\u6BB5\u7EA7 PATCH\uFF0C\u53EA\u5199\u672C\u6B21\u4F20\u5165\u7684\u5B57\u6BB5"
   ).requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <adId>", "\u5E7F\u544A ID").option(
     "--headlines <h1,h2,h3,...>",
     "\u65B0\u6807\u9898\u5217\u8868\uFF0C\u9017\u53F7\u5206\u9694\uFF08\u81F3\u5C11 3 \u4E2A\uFF0C\u6700\u591A 15 \u4E2A\uFF0C\u6BCF\u4E2A \u226430 \u5B57\u7B26\uFF1B\u6620\u5C04 headlinePart1/2/3 \u4E0E AddtionalHeadlines\uFF09",
@@ -125273,7 +125409,7 @@ function register21(program2) {
       });
     }
   );
-  adCmd.command("keyword-edit").description("\u7F16\u8F91\u641C\u7D22\u5173\u952E\u8BCD\uFF08\u6570\u7EC4 body\uFF0C\u5148 list \u518D\u5408\u5E76\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --json-out \u2192 id\uFF09").option("--text <text>", "\u65B0\u5173\u952E\u8BCD\u6587\u672C\uFF08\u5199\u5165 keywordText \u6570\u7EC4\uFF09").option(
+  adCmd.command("keyword-edit").description("\u7F16\u8F91\u641C\u7D22\u5173\u952E\u8BCD\u3002\u72B6\u6001/\u51FA\u4EF7/\u7F51\u5740\u8D70\u5B57\u6BB5\u7EA7 PATCH\uFF1B\u6539\u8BCD\u9762\u6216\u5339\u914D\u7C7B\u578B\u4ECD\u7528\u6279\u91CF PUT").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --json-out \u2192 id\uFF09").option("--text <text>", "\u65B0\u5173\u952E\u8BCD\u6587\u672C\uFF08\u5199\u5165 keywordText \u6570\u7EC4\uFF09").option(
     "--match-type <type>",
     '\u65B0\u5339\u914D\u7C7B\u578B\uFF1ABroad | Phrase | Exact\uFF08\u5199 matchTypeV2\uFF0C\u5E76\u9ED8\u8BA4\u540C\u6B65\u6539\u5199 keywordText \u4E3A\u8BCD\u5E72/"\u8BCD"/[\u8BCD] \u4EE5\u7B26\u5408\u7F51\u5173\u63A8\u65AD\uFF09'
   ).option(
@@ -125312,7 +125448,7 @@ function register21(program2) {
       });
     }
   );
-  adCmd.command("keyword-status").description("\u5207\u6362\u641C\u7D22\u5173\u952E\u8BCD\u72B6\u6001\uFF08Enabled / Paused\uFF0C\u5199\u5165 userStatusV2\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --json-out \u2192 id\uFF09").requiredOption("--status <status>", "\u76EE\u6807\u72B6\u6001\uFF1AEnabled | Paused").option("--start <date>", "\u5217\u8868\u67E5\u8BE2\u8D77\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u5217\u8868\u67E5\u8BE2\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
+  adCmd.command("keyword-status").description("\u5207\u6362\u641C\u7D22\u5173\u952E\u8BCD\u72B6\u6001\uFF08Enabled / Paused\uFF0C\u5B57\u6BB5\u7EA7 PATCH userStatus\uFF09").requiredOption("-a, --account <id>", "Google \u8D26\u6237 mediaCustomerId").requiredOption("--id <keywordId>", "\u5173\u952E\u8BCD ID\uFF08\u6765\u81EA ad keywords --json-out \u2192 id\uFF09").requiredOption("--status <status>", "\u76EE\u6807\u72B6\u6001\uFF1AEnabled | Paused").option("--start <date>", "\u5217\u8868\u67E5\u8BE2\u8D77\u59CB\u65E5\u671F YYYY-MM-DD").option("--end <date>", "\u5217\u8868\u67E5\u8BE2\u7ED3\u675F\u65E5\u671F YYYY-MM-DD").option("-t, --token <token>", "Auth Token").option("--verbose", "\u8BE6\u7EC6\u9519\u8BEF\u4FE1\u606F", false).action(
     async (opts) => {
       if (opts.status !== "Enabled" && opts.status !== "Paused") {
         console.error("\n\u274C --status \u53EA\u63A5\u53D7 Enabled \u6216 Paused\n");