@adkit/cli 1.12.16 → 1.12.18

package/dist/cli.js

@@ -1815,7 +1815,8 @@ var ASSET_CREATE_FLAGS = ["type", "text", "sitelink", "header", "value", "descri
 var ASSET_LINK_FLAGS = ["type", "scope", "scope-id", "status"];
 var MEDIA_UPLOAD_FLAGS = ["file", "url", "base64", "adkit-media", "filename", "content-type", "name"];
 var CAMPAIGN_LIST_FLAGS = ["status", "limit", "offset"];
-var CAMPAIGN_FLAGS2 = ["name", "status", "budget-daily", "campaign-type", "bid-strategy", "search-partners", "display-network", "tracking-url-suffix", "countries"];
+var CAMPAIGN_CREATE_FLAGS = ["name", "status", "budget-daily", "campaign-type", "bid-strategy", "search-partners", "display-network", "tracking-url-suffix", "countries"];
+var CAMPAIGN_UPDATE_FLAGS = ["name", "status", "budget-daily", "bid-strategy", "search-partners", "display-network", "tracking-url-suffix", "countries"];
 var AD_GROUP_LIST_FLAGS = ["campaign", "status", "limit", "offset"];
 var AD_GROUP_FLAGS = ["campaign", "name", "status", "cpc-bid"];
 var AD_LIST_FLAGS = ["ad-group", "status", "policy-status", "limit", "offset"];
@@ -1832,6 +1833,7 @@ var SEARCH_TERMS_FLAGS = ["campaign", "ad-group", "keyword", "keyword-match-type
 var PLACEMENT_REPORT_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "raw"];
 var GOOGLE_RESULTS_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "status", "breakdown", "fields", "raw"];
 var GOOGLE_KEYWORD_RESULTS_FLAGS = ["campaign", "ad-group", "period", "from", "to", "sort", "limit", "status", "fields", "raw"];
+var CHANGE_HISTORY_FLAGS = ["account", "period", "from", "to", "limit"];
 var KEYWORD_RESEARCH_FLAGS = ["url", "location", "language", "limit", "min-volume"];
 var TARGETING_RESEARCH_FLAGS = ["limit"];
 function generateCampaignName2() {
@@ -1871,6 +1873,12 @@ function buildGoogleMutationQuery(flags, body, extra = {}) {
   const publish = flags.publish === true ? "true" : void 0;
   return queryString({ accountId, publish, ...extra });
 }
+function removeQueryOnlyBodyKeys(body, keys) {
+  if (typeof body !== "object" || body === null || Array.isArray(body)) return body;
+  const dropKeys = new Set(keys);
+  const bodyEntries = Object.entries(body).filter(([key]) => !dropKeys.has(key));
+  return Object.fromEntries(bodyEntries);
+}
 function buildGoogleAssetQuery(flags, extra = {}) {
   const accountId = typeof flags.account === "string" ? flags.account : void 0;
   const type = typeof flags.type === "string" ? flags.type : void 0;
@@ -1970,11 +1978,30 @@ function buildCampaignPayload2(flags) {
   if (flags["search-partners"] === true) payload.searchPartners = true;
   if (flags["display-network"] === true) payload.displayNetwork = true;
   if (typeof flags["tracking-url-suffix"] === "string") payload.trackingUrlSuffix = flags["tracking-url-suffix"];
+  if (typeof flags.countries === "string") payload.countries = parseCampaignCountries(flags.countries);
+  return payload;
+}
+function parseCampaignCountries(value) {
+  const countryParts = value.split(",");
+  const normalizedCountries = countryParts.map((country) => country.trim().toUpperCase());
+  return normalizedCountries.filter(Boolean);
+}
+function buildCampaignUpdatePayloadFromFlags(flags) {
+  const payload = {};
+  if (typeof flags.name === "string") payload.name = flags.name;
+  if (typeof flags.status === "string") payload.status = flags.status;
+  if (typeof flags["budget-daily"] === "string") payload.budget = { daily: Number.parseFloat(flags["budget-daily"]) };
+  if (typeof flags["bid-strategy"] === "string") payload.bidStrategy = flags["bid-strategy"];
+  if (flags["search-partners"] === true) payload.searchPartners = true;
+  if (flags["display-network"] === true) payload.displayNetwork = true;
+  if (typeof flags["tracking-url-suffix"] === "string") payload.trackingUrlSuffix = flags["tracking-url-suffix"];
   if (typeof flags.countries === "string") {
-    payload.countries = flags.countries.split(",").map((country) => {
-      const normalizedCountry = country.trim();
-      return normalizedCountry.toUpperCase();
-    });
+    const countries = parseCampaignCountries(flags.countries);
+    payload.targeting = {
+      geoLocations: {
+        include: countries.map((country) => ({ type: "country", country }))
+      }
+    };
   }
   return payload;
 }
@@ -2284,7 +2311,7 @@ async function getCampaign2(client, args, flags) {
   return client.get(path3);
 }
 async function createCampaign2(client, _args, flags) {
-  validateFlags(flags, CAMPAIGN_FLAGS2, "manage google campaigns create");
+  validateFlags(flags, CAMPAIGN_CREATE_FLAGS, "manage google campaigns create");
   if (typeof flags.data === "string") {
     const body2 = parseDataFlag(flags, "Check JSON syntax in --data");
     const qs2 = buildGoogleMutationQuery(flags, body2);
@@ -2300,15 +2327,17 @@ async function createCampaign2(client, _args, flags) {
 }
 async function updateCampaign2(client, args, flags) {
   const id = requireArg(args, 0, "campaign-id", "Run: adkit manage google campaigns update <campaign-id> --status paused");
-  validateFlags(flags, CAMPAIGN_FLAGS2, "manage google campaigns update");
+  validateFlags(flags, CAMPAIGN_UPDATE_FLAGS, "manage google campaigns update");
   if (typeof flags.data === "string") {
-    const body = parseDataFlag(flags, "Check JSON syntax in --data");
-    const qs2 = buildGoogleMutationQuery(flags, body);
+    const rawBody = parseDataFlag(flags, "Check JSON syntax in --data");
+    const qs2 = buildGoogleMutationQuery(flags, rawBody);
+    const body = removeQueryOnlyBodyKeys(rawBody, ["accountId"]);
     const path4 = `/manage/google/campaigns/${id}${qs2}`;
     return client.patch(path4, body);
   }
-  const payload = buildCampaignPayload2(flags);
-  const qs = buildGoogleMutationQuery(flags, payload);
+  const rawPayload = buildCampaignUpdatePayloadFromFlags(flags);
+  const qs = buildGoogleMutationQuery(flags, rawPayload);
+  const payload = removeQueryOnlyBodyKeys(rawPayload, ["accountId"]);
   const path3 = `/manage/google/campaigns/${id}${qs}`;
   return client.patch(path3, payload);
 }
@@ -2458,19 +2487,21 @@ async function updateKeyword(client, args, flags) {
   const id = requireArg(args, 0, "keyword-id", "Run: adkit manage google keywords update <keyword-id> --status paused --ad-group 123456");
   validateFlags(flags, KEYWORD_UPDATE_FLAGS, "manage google keywords update");
   if (typeof flags.data === "string") {
-    const body = parseDataFlag(flags, "Check JSON syntax in --data");
-    const adGroupId2 = resolveGoogleAdGroupId(body, flags);
+    const rawBody = parseDataFlag(flags, "Check JSON syntax in --data");
+    const adGroupId2 = resolveGoogleAdGroupId(rawBody, flags);
     if (!adGroupId2) throw new CliError("MISSING_FLAG", "Missing required flag: `--ad-group`", "Provide --ad-group <id> or include adGroupId in --data");
-    const qs2 = buildGoogleMutationQuery(flags, body, { adGroupId: adGroupId2 });
+    const qs2 = buildGoogleMutationQuery(flags, rawBody, { adGroupId: adGroupId2 });
+    const body2 = removeQueryOnlyBodyKeys(rawBody, ["accountId", "adGroupId"]);
     const path4 = `/manage/google/keywords/${id}${qs2}`;
-    return client.patch(path4, body);
+    return client.patch(path4, body2);
   }
   const payload = buildKeywordPayload(flags);
   const adGroupId = resolveGoogleAdGroupId(payload, flags);
   if (!adGroupId) throw new CliError("MISSING_FLAG", "Missing required flag: `--ad-group`", "Run: adkit manage google keywords update <keyword-id> --ad-group <ad-group-id> ...");
   const qs = buildGoogleMutationQuery(flags, payload, { adGroupId });
+  const body = removeQueryOnlyBodyKeys(payload, ["accountId", "adGroupId"]);
   const path3 = `/manage/google/keywords/${id}${qs}`;
-  return client.patch(path3, payload);
+  return client.patch(path3, body);
 }
 async function removeKeyword(client, args, flags) {
   validateFlags(flags, ["ad-group"], "manage google keywords remove");
@@ -2634,6 +2665,15 @@ async function listGooglePlacements(client, _args, flags) {
   const qs = buildPlacementReportQuery(flags);
   return client.get(`/manage/google/results/placements${qs}`);
 }
+async function listGoogleChangeHistory(client, _args, flags) {
+  validateFlags(flags, CHANGE_HISTORY_FLAGS, "manage google change-history list");
+  const period = typeof flags.period === "string" ? flags.period : void 0;
+  const from = typeof flags.from === "string" ? flags.from : void 0;
+  const to = typeof flags.to === "string" ? flags.to : void 0;
+  const qs = buildGoogleListQuery(flags, { period, from, to });
+  const path3 = `/manage/google/change-history${qs}`;
+  return client.get(path3);
+}
 async function listGoogleKeywordResults(client, _args, flags) {
   validateFlags(flags, GOOGLE_KEYWORD_RESULTS_FLAGS, "manage google results keywords");
   const accountId = typeof flags.account === "string" ? flags.account : void 0;
@@ -2693,8 +2733,8 @@ var MEDIA_UPLOAD_FLAGS2 = ["file", "url", "base64", "adkit-media", "temporary-up
 var MEDIA_LIST_FLAGS = ["video-id", "material-id", "displayable", "width", "height", "ratio", "limit", "offset"];
 var CAMPAIGN_LIST_FLAGS2 = ["campaign-ids", "fields", "limit", "offset"];
 var PLATFORM_OVERRIDE_FLAG = "platform-overrides";
-var CAMPAIGN_CREATE_FLAGS = ["name", "objective", "status", "budget-daily", "budget-lifetime", PLATFORM_OVERRIDE_FLAG];
-var CAMPAIGN_UPDATE_FLAGS = ["name", "status", "budget-daily", "budget-lifetime", PLATFORM_OVERRIDE_FLAG];
+var CAMPAIGN_CREATE_FLAGS2 = ["name", "objective", "status", "budget-daily", "budget-lifetime", PLATFORM_OVERRIDE_FLAG];
+var CAMPAIGN_UPDATE_FLAGS2 = ["name", "status", "budget-daily", "budget-lifetime", PLATFORM_OVERRIDE_FLAG];
 var AD_GROUP_LIST_FLAGS2 = ["campaign-ids", "fields", "limit", "offset"];
 var AD_GROUP_CREATE_FLAGS = ["campaign", "name", "status", "budget-daily", "budget-lifetime", "billing-event", "bid-strategy", "optimization", "start-date", "end-date", "pacing", "bid-amount", "event-type", "pixel", "placement", PLATFORM_OVERRIDE_FLAG];
 var AD_GROUP_UPDATE_FLAGS = ["name", "status", "budget-daily", "budget-lifetime", "billing-event", "optimization", "start-date", "end-date", "pacing", "bid-amount", "event-type", "pixel", PLATFORM_OVERRIDE_FLAG];
@@ -2955,7 +2995,7 @@ async function getTikTokCampaign(client, args, flags) {
   return client.get(`/manage/tiktok/campaigns/${id}${buildTikTokListQuery(flags)}`);
 }
 async function createTikTokCampaign(client, _args, flags) {
-  validateFlags(flags, CAMPAIGN_CREATE_FLAGS, "manage tiktok campaigns create");
+  validateFlags(flags, CAMPAIGN_CREATE_FLAGS2, "manage tiktok campaigns create");
   if (typeof flags.data === "string") {
     const body2 = parseDataFlag(flags, 'Use { "campaigns": [...] } for TikTok campaign create');
     return client.post(`/manage/tiktok/campaigns${buildTikTokMutationQuery(flags)}`, body2);
@@ -2964,7 +3004,7 @@ async function createTikTokCampaign(client, _args, flags) {
   return client.post(`/manage/tiktok/campaigns${buildTikTokMutationQuery(flags)}`, body);
 }
 async function updateTikTokCampaign(client, args, flags) {
-  validateFlags(flags, CAMPAIGN_UPDATE_FLAGS, "manage tiktok campaigns update");
+  validateFlags(flags, CAMPAIGN_UPDATE_FLAGS2, "manage tiktok campaigns update");
   const id = requireArg(args, 0, "campaign-id", "Run: adkit manage tiktok campaigns update <campaign-id> --status paused");
   const body = typeof flags.data === "string" ? parseDataFlag(flags, "Use a flat TikTok campaign changes object") : buildTikTokCampaignPayload(flags, "update");
   return client.patch(`/manage/tiktok/campaigns/${id}${buildTikTokMutationQuery(flags)}`, body);
@@ -4633,6 +4673,7 @@ Flags (update):
   --status <s>        enabled, paused
   --budget-daily <n>  Daily budget in account currency
   --bid-strategy <s>  Change bidding strategy
+  --countries <codes> Replace included countries, e.g. US,CA
 
 Flags (list):
   --status <s>        Filter by campaign status (default: enabled,paused; use all for every status)
@@ -4679,6 +4720,7 @@ Flags (update):
   --status <s>        enabled, paused
   --budget-daily <n>  Daily budget in account currency
   --bid-strategy <s>  Change bidding strategy
+  --countries <codes> Replace included countries, e.g. US,CA
 ${FLAG.account}
 ${FLAG.publish}
 ${FLAG.data}
@@ -4918,6 +4960,7 @@ Flags (list):
 
 Note:
   list returns keyword configuration (bids, match type, status) only.
+  update only changes mutable fields: status and cpc bid.
   Google Ads cannot edit keyword text or match type; pause or remove the old keyword, then create a new one.
   For spend/clicks/conversions per keyword: adkit manage google results keywords
 
@@ -4959,6 +5002,7 @@ Flags (list):
 
 Note:
   list returns keyword configuration (bids, match type, status) only.
+  update only changes mutable fields: status and cpc bid. Raw --data for update must not include text or matchType.
   Google Ads cannot edit keyword text or match type; pause or remove the old keyword, then create a new one.
   For spend/clicks/conversions per keyword: adkit manage google results keywords
 
@@ -5080,6 +5124,32 @@ Examples:
   adkit manage google results --period this_month --sort clicks --limit 20
   adkit manage google results search-terms --campaign 123 --period 30d
   adkit manage google results --campaign 123 --fields all`;
+var GOOGLE_CHANGE_HISTORY_HELP = `adkit manage google change-history \u2014 recent Google Ads account changes
+
+  Read-only audit log of who changed what and when (campaigns, budgets, ad
+  groups, ads, keywords, etc.). Google only keeps the last 30 days.
+
+  list                Recent changes as compact diffs (default action)
+
+Flags:
+  --account <id>      Optional if one Google Ads account is connected
+  --period <period>   Date range (7d, 14d, 30d, this_month, maximum, etc. Default: 7d, max 30d back)
+  --from <date>       Start date (YYYY-MM-DD, requires --to). Window must be <= 30 days and within the last 30 days.
+  --to <date>         End date (YYYY-MM-DD, requires --from)
+  --limit <n>         Max changes (default: 50, max: 10000)
+
+Each record:
+  time, resourceType, resourceName, operation (create | update | remove),
+  changedBy, clientType, changes: [{ field, oldValue, newValue }]
+  create shows only newValue; update shows old + new; remove has no field changes.
+
+Note:
+  Hard 30-day cap \u2014 a range that starts more than 30 days ago returns an error.
+
+Examples:
+  adkit manage google change-history list --period 7d
+  adkit manage google change-history list --period 30d --limit 200
+  adkit manage google change-history list --from 2026-06-01 --to 2026-06-15`;
 var GOOGLE_RESULTS_PLACEMENTS_HELP = `adkit manage google results placements \u2014 Google placement report
 
   Shows each website, app, or YouTube placement where ads appeared.
@@ -5265,6 +5335,7 @@ Examples:
   "google results placements": GOOGLE_RESULTS_PLACEMENTS_HELP,
   "google results search-terms": GOOGLE_KEYWORD_SEARCH_TERMS_HELP,
   "google results keywords": GOOGLE_RESULTS_KEYWORDS_HELP,
+  "google change-history": GOOGLE_CHANGE_HISTORY_HELP,
   "google research": GOOGLE_RESEARCH_HELP,
   "google media": GOOGLE_MEDIA_HELP,
   "tiktok accounts": `adkit manage tiktok accounts \u2014 TikTok Ads accounts
@@ -5509,6 +5580,7 @@ Entity groups:
   keywords            Manage keywords and negatives \u2014 config only, not metrics
   keywords negative-lists   Shared negative keyword lists (create, attach to campaigns)
   results             Performance metrics (campaigns, ad-groups, ads, keywords, search-terms)
+  change-history      Recent Google Ads account changes from the last 30 days
   research            Keyword Planner plus Display topic/interest IDs
   assets              Manage reusable assets (sitelinks, callouts, structured snippets, images)
   media               Upload images for Display creative media
@@ -5800,6 +5872,7 @@ var HELP_FULL = {
   "google results placements": GOOGLE_RESULTS_PLACEMENTS_HELP,
   "google results search-terms": GOOGLE_KEYWORD_SEARCH_TERMS_HELP_FULL,
   "google results keywords": GOOGLE_RESULTS_KEYWORDS_HELP,
+  "google change-history": GOOGLE_CHANGE_HISTORY_HELP,
   "google research": GOOGLE_RESEARCH_HELP,
   "google media": GOOGLE_MEDIA_HELP,
   "meta research": META_RESEARCH_HELP,
@@ -7118,6 +7191,12 @@ async function main() {
             else data = await listGoogleResults(client, restArgs, flags);
             break;
           }
+          case "change-history": {
+            if (action && action !== "list") throw new CliError("UNKNOWN_COMMAND", `Unknown action: google change-history ${action}`, "Available: list");
+            data = await listGoogleChangeHistory(client, restArgs, flags);
+            emptyHint = "No changes found in the selected window. Try a wider --period (max 30d).";
+            break;
+          }
           case "research": {
             switch (action) {
               case "keywords":
@@ -7138,7 +7217,7 @@ async function main() {
             break;
           }
           default:
-            throw new CliError("UNKNOWN_COMMAND", `Unknown entity: google ${entity}`, "Available: accounts, assets, media, campaigns, ad-groups, ads, keywords, results, research");
+            throw new CliError("UNKNOWN_COMMAND", `Unknown entity: google ${entity}`, "Available: accounts, assets, media, campaigns, ad-groups, ads, keywords, results, change-history, research");
         }
       } else if (platform2 === "tiktok") {
         switch (entity) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.12.16",
+  "version": "1.12.18",
   "description": "The Ads CLI for AI agents — manage Meta & Google ad campaigns, browse the ad library, and generate creatives from your terminal.",
   "keywords": [
     "ads cli",