@adkit/cli 1.12.17 → 1.12.19

package/dist/cli.js

@@ -1833,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", "resource", "campaign", "ad-group"];
 var KEYWORD_RESEARCH_FLAGS = ["url", "location", "language", "limit", "min-volume"];
 var TARGETING_RESEARCH_FLAGS = ["limit"];
 function generateCampaignName2() {
@@ -2664,6 +2665,18 @@ 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 resource = typeof flags.resource === "string" ? flags.resource : void 0;
+  const campaignId = typeof flags.campaign === "string" ? flags.campaign : void 0;
+  const adGroupId = typeof flags["ad-group"] === "string" ? flags["ad-group"] : void 0;
+  const qs = buildGoogleListQuery(flags, { period, from, to, resource, campaignId, adGroupId });
+  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;
@@ -5114,6 +5127,37 @@ 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)
+  --resource <type>   campaign | ad-group | ad | keyword
+  --campaign <id>     Filter to changes affecting one campaign
+  --ad-group <id>     Filter to changes affecting one ad group
+
+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 7d --resource campaign
+  adkit manage google change-history list --period 7d --campaign 123456789
+  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.
@@ -5299,6 +5343,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
@@ -5543,6 +5588,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
@@ -5834,6 +5880,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,
@@ -7152,6 +7199,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":
@@ -7172,7 +7225,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.17",
+  "version": "1.12.19",
   "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",