@adkit/cli 1.13.20 → 1.13.21

package/dist/cli.js

@@ -88,6 +88,108 @@ var CliError = class extends Error {
   }
 };
 
+// src/cli-utils.ts
+function parseArgs(argv, options) {
+  const args = [];
+  const flags = {};
+  const multiSet = new Set(options?.multi);
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+    if (!arg.startsWith("--")) {
+      args.push(arg);
+      continue;
+    }
+    const eqIdx = arg.indexOf("=");
+    let key;
+    let value;
+    if (eqIdx !== -1) {
+      key = arg.slice(2, eqIdx);
+      value = arg.slice(eqIdx + 1);
+    } else {
+      key = arg.slice(2);
+      const next = argv[i + 1];
+      if (next && !next.startsWith("--")) {
+        value = next;
+        i++;
+      } else value = true;
+    }
+    if (multiSet.has(key) && typeof value === "string") {
+      const existing = flags[key];
+      if (Array.isArray(existing)) existing.push(value);
+      else flags[key] = [value];
+    } else flags[key] = value;
+  }
+  return { args, flags };
+}
+var GLOBAL_FLAGS = ["account", "json", "fields", "publish", "data", "platform-overrides", "force", "project"];
+function validateFlags(flags, allowed, command) {
+  const allAllowed = /* @__PURE__ */ new Set([...GLOBAL_FLAGS, ...allowed]);
+  const unknown = Object.keys(flags).filter((k) => !allAllowed.has(k));
+  if (unknown.length) throw new CliError("UNKNOWN_FLAG", `Unknown flag${unknown.length > 1 ? "s" : ""}: ${unknown.map((f) => `--${f}`).join(", ")}`, `Run: adkit ${command} --help`);
+}
+function requireArg(args, index, label, hint) {
+  const val = args[index];
+  if (!val) throw new CliError("MISSING_ARGUMENT", `Missing required argument: \`<${label}>\``, hint);
+  return val;
+}
+function requireFlag(flags, key, hint) {
+  const val = flags[key];
+  if (typeof val !== "string") throw new CliError("MISSING_FLAG", `Missing required flag: \`--${key}\``, hint);
+  return val;
+}
+function parseDataFlag(flags, hint) {
+  const raw = requireFlag(flags, "data", hint);
+  try {
+    return JSON.parse(raw);
+  } catch {
+    const truncated = raw.length > 80 ? raw.slice(0, 80) + "..." : raw;
+    throw new CliError("INVALID_VALUE", `Invalid JSON in \`--data\` flag: ${truncated}`, "Check JSON syntax in --data");
+  }
+}
+function mergeAccountId(body, flags) {
+  if (typeof body !== "object" || body === null || Array.isArray(body)) return body;
+  const obj = body;
+  if (!obj.accountId && typeof flags.account === "string") obj.accountId = flags.account;
+  return obj;
+}
+function queryString(params) {
+  const entries = Object.entries(params).filter((entry) => entry[1] !== void 0);
+  if (entries.length === 0) return "";
+  return "?" + entries.map(([key, value]) => `${key}=${encodeURIComponent(value)}`).join("&");
+}
+function isDisplayRow(value) {
+  return typeof value === "object" && value !== null;
+}
+function isDisplayRowEntry(value) {
+  return isDisplayRow(value);
+}
+function isDisplayRowArray(value) {
+  if (!Array.isArray(value)) return false;
+  const everyItemIsDisplayRow = value.every(isDisplayRowEntry);
+  return everyItemIsDisplayRow;
+}
+function isWrappedRowArray(value) {
+  return isDisplayRowArray(value);
+}
+function getDateStamp() {
+  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+}
+function collectFlagValues(flags, key) {
+  const value = flags[key];
+  if (Array.isArray(value)) return value;
+  if (typeof value === "string") return [value];
+  return [];
+}
+function unwrapList(data) {
+  if (isDisplayRowArray(data)) return data;
+  if (data && typeof data === "object") {
+    const values = Object.values(data);
+    const rowArray = values.find(isWrappedRowArray);
+    if (rowArray) return rowArray;
+  }
+  return [];
+}
+
 // src/client.ts
 var noticePrinted = false;
 function printServerNotice(response) {
@@ -166,22 +268,53 @@ function buildAuthSuggestion(code) {
   if (!AUTH_CODES.has(normalizedCode)) return void 0;
   return "Run: adkit setup manage";
 }
+function appendReadQueryFallback(path3, rawData) {
+  const parsedData = parseDataFlag({ data: rawData }, "Use a flat JSON object for read query parameters");
+  if (typeof parsedData !== "object" || parsedData === null || Array.isArray(parsedData)) throw new CliError("INVALID_VALUE", "Read --data must be a flat JSON object", 'Use an object such as {"adGroupIds":["123"]}');
+  const queryStart = path3.indexOf("?");
+  const existingQuery = queryStart === -1 ? "" : path3.slice(queryStart + 1);
+  const existingParams = new URLSearchParams(existingQuery);
+  const extraParams = [];
+  for (const [key, value] of Object.entries(parsedData)) {
+    const values = Array.isArray(value) ? value : [value];
+    if (values.length === 0) throw new CliError("INVALID_VALUE", `Cannot use --data field \`${key}\` as a read query parameter`, "Use a string, finite number, boolean, or non-empty array of those values");
+    const queryItems = [];
+    for (const item of values) {
+      const isScalar = typeof item === "string" || typeof item === "boolean" || typeof item === "number" && Number.isFinite(item);
+      if (!isScalar) throw new CliError("INVALID_VALUE", `Cannot use --data field \`${key}\` as a read query parameter`, "Use a string, finite number, boolean, or non-empty array of those values");
+      const queryItem = String(item);
+      queryItems.push(queryItem);
+    }
+    const queryValue = queryItems.join(",");
+    if (existingParams.has(key)) continue;
+    const encodedKey = encodeURIComponent(key);
+    const encodedValue = encodeURIComponent(queryValue);
+    extraParams.push(`${encodedKey}=${encodedValue}`);
+  }
+  if (extraParams.length === 0) return path3;
+  const separator = queryStart === -1 ? "?" : "&";
+  return `${path3}${separator}${extraParams.join("&")}`;
+}
 var AdkitClient = class {
   apiKey;
   baseUrl;
   clientVersion;
   projectId;
-  constructor({ apiKey, baseUrl, clientVersion, projectId }) {
+  readQueryFallback;
+  constructor({ apiKey, baseUrl, clientVersion, projectId, readQueryFallback }) {
     const isLocalhost = baseUrl.startsWith("http://localhost") || baseUrl.startsWith("http://127.0.0.1");
     if (baseUrl.startsWith("http://") && !isLocalhost) throw new Error("HTTPS is required \u2014 insecure HTTP base URLs are not allowed");
     this.apiKey = apiKey;
     this.baseUrl = baseUrl;
     this.clientVersion = clientVersion;
     this.projectId = projectId;
+    this.readQueryFallback = readQueryFallback;
   }
   // eslint-disable-next-line max-lines-per-function -- shared client error mapping is intentionally centralized here.
   async request(method, path3, body) {
-    const url = `${this.baseUrl}${path3}`;
+    if (method !== "GET") this.readQueryFallback = void 0;
+    const requestPath = method === "GET" && this.readQueryFallback !== void 0 ? appendReadQueryFallback(path3, this.readQueryFallback) : path3;
+    const url = `${this.baseUrl}${requestPath}`;
     const headers = {
       Authorization: `Bearer ${this.apiKey}`,
       "Content-Type": "application/json",
@@ -249,7 +382,7 @@ var AdkitClient = class {
         throw error2;
       }
       if (response.status === 404) {
-        const fallback = `Not found: ${method} ${path3} \u2014 the resource may have been deleted or the ID is wrong`;
+        const fallback = `Not found: ${method} ${requestPath} \u2014 the resource may have been deleted or the ID is wrong`;
         const error2 = new CliError("NOT_FOUND", appendErrorDetail(serverMessage || fallback, batchSummary), "Check the resource ID");
         error2.notice = serverNotice;
         throw error2;
@@ -1022,108 +1155,6 @@ function logout() {
   console.log("Logged out \u2014 API key removed.");
 }
 
-// src/cli-utils.ts
-function parseArgs(argv, options) {
-  const args = [];
-  const flags = {};
-  const multiSet = new Set(options?.multi);
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    if (!arg.startsWith("--")) {
-      args.push(arg);
-      continue;
-    }
-    const eqIdx = arg.indexOf("=");
-    let key;
-    let value;
-    if (eqIdx !== -1) {
-      key = arg.slice(2, eqIdx);
-      value = arg.slice(eqIdx + 1);
-    } else {
-      key = arg.slice(2);
-      const next = argv[i + 1];
-      if (next && !next.startsWith("--")) {
-        value = next;
-        i++;
-      } else value = true;
-    }
-    if (multiSet.has(key) && typeof value === "string") {
-      const existing = flags[key];
-      if (Array.isArray(existing)) existing.push(value);
-      else flags[key] = [value];
-    } else flags[key] = value;
-  }
-  return { args, flags };
-}
-var GLOBAL_FLAGS = ["account", "json", "fields", "publish", "data", "platform-overrides", "force", "project"];
-function validateFlags(flags, allowed, command) {
-  const allAllowed = /* @__PURE__ */ new Set([...GLOBAL_FLAGS, ...allowed]);
-  const unknown = Object.keys(flags).filter((k) => !allAllowed.has(k));
-  if (unknown.length) throw new CliError("UNKNOWN_FLAG", `Unknown flag${unknown.length > 1 ? "s" : ""}: ${unknown.map((f) => `--${f}`).join(", ")}`, `Run: adkit ${command} --help`);
-}
-function requireArg(args, index, label, hint) {
-  const val = args[index];
-  if (!val) throw new CliError("MISSING_ARGUMENT", `Missing required argument: \`<${label}>\``, hint);
-  return val;
-}
-function requireFlag(flags, key, hint) {
-  const val = flags[key];
-  if (typeof val !== "string") throw new CliError("MISSING_FLAG", `Missing required flag: \`--${key}\``, hint);
-  return val;
-}
-function parseDataFlag(flags, hint) {
-  const raw = requireFlag(flags, "data", hint);
-  try {
-    return JSON.parse(raw);
-  } catch {
-    const truncated = raw.length > 80 ? raw.slice(0, 80) + "..." : raw;
-    throw new CliError("INVALID_VALUE", `Invalid JSON in \`--data\` flag: ${truncated}`, "Check JSON syntax in --data");
-  }
-}
-function mergeAccountId(body, flags) {
-  if (typeof body !== "object" || body === null || Array.isArray(body)) return body;
-  const obj = body;
-  if (!obj.accountId && typeof flags.account === "string") obj.accountId = flags.account;
-  return obj;
-}
-function queryString(params) {
-  const entries = Object.entries(params).filter((entry) => entry[1] !== void 0);
-  if (entries.length === 0) return "";
-  return "?" + entries.map(([key, value]) => `${key}=${encodeURIComponent(value)}`).join("&");
-}
-function isDisplayRow(value) {
-  return typeof value === "object" && value !== null;
-}
-function isDisplayRowEntry(value) {
-  return isDisplayRow(value);
-}
-function isDisplayRowArray(value) {
-  if (!Array.isArray(value)) return false;
-  const everyItemIsDisplayRow = value.every(isDisplayRowEntry);
-  return everyItemIsDisplayRow;
-}
-function isWrappedRowArray(value) {
-  return isDisplayRowArray(value);
-}
-function getDateStamp() {
-  return (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
-}
-function collectFlagValues(flags, key) {
-  const value = flags[key];
-  if (Array.isArray(value)) return value;
-  if (typeof value === "string") return [value];
-  return [];
-}
-function unwrapList(data) {
-  if (isDisplayRowArray(data)) return data;
-  if (data && typeof data === "object") {
-    const values = Object.values(data);
-    const rowArray = values.find(isWrappedRowArray);
-    if (rowArray) return rowArray;
-  }
-  return [];
-}
-
 // src/commands/projects.ts
 async function createProject(client, options) {
   const response = await client.post("/manage/projects", options);
@@ -1888,6 +1919,18 @@ function parseGoogleSitelinkShorthand(value) {
   return normalizeSitelinkAsset({ type: "sitelink", linkText, finalUrls: [finalUrl] });
 }
 
+// ../shared/dist/utils/type-guards.js
+function isPlainObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readProperty(value, key) {
+  return value[key];
+}
+function readStringProperty(value, key) {
+  const raw = value[key];
+  return typeof raw === "string" ? raw : void 0;
+}
+
 // src/commands/google.ts
 import { readFileSync as readFileSync2 } from "node:fs";
 import { basename, extname, resolve } from "node:path";
@@ -1899,6 +1942,9 @@ var MEDIA_UPLOAD_FLAGS = ["file", "url", "base64", "adkit-media", "video-id", "f
 var CAMPAIGN_LIST_FLAGS = ["status", "limit", "offset"];
 var CAMPAIGN_CREATE_FLAGS = ["name", "status", "budget-daily", "campaign-type", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "countries"];
 var CAMPAIGN_UPDATE_FLAGS = ["name", "status", "budget-daily", "bid-strategy", "target-cpa", "target-roas", "search-partners", "display-network", "tracking-url-suffix", "countries"];
+var ASSET_GROUP_LIST_FLAGS = ["campaign", "limit", "offset"];
+var ASSET_GROUP_CREATE_FLAGS = ["campaign", "name", "status", "final-url"];
+var ASSET_GROUP_UPDATE_FLAGS = ["name", "status", "final-url"];
 var AD_GROUP_LIST_FLAGS = ["campaign", "status", "limit", "offset"];
 var AD_GROUP_FLAGS = ["campaign", "name", "status", "cpc-bid"];
 var AD_LIST_FLAGS = ["ad-group", "campaign", "status", "policy-status", "limit", "offset"];
@@ -1921,6 +1967,7 @@ var KEYWORD_RESEARCH_FLAGS = ["url", "location", "language", "limit", "min-volum
 var TARGETING_RESEARCH_FLAGS = ["limit"];
 var GEO_LOCATION_SEARCH_FLAGS = ["country-code", "locale", "type", "limit"];
 var NUMBER_FLAG_PATTERN = /^(?:\d+|\d+\.\d+|\.\d+)(?:e[+-]?\d+)?$/iu;
+var GOOGLE_NUMERIC_ID_PATTERN = /^\d+$/u;
 function generateCampaignName2() {
   return `campaign ${getDateStamp()}`;
 }
@@ -1995,6 +2042,52 @@ function requireAssetReference(args, hint) {
     throw new CliError("INVALID_VALUE", `Invalid asset reference: ${value}`, "Use asset:<numeric-id>, e.g. asset:123456789");
   }
 }
+function requireGoogleNumericId(args, label, hint) {
+  const value = requireArg(args, 0, label, hint);
+  if (!GOOGLE_NUMERIC_ID_PATTERN.test(value)) throw new CliError("INVALID_VALUE", `Invalid ${label}: ${value}`, "Use the numeric Google Ads platformId returned by list/get");
+  return value;
+}
+function mergeGoogleAssetGroupAccountId(body, flags) {
+  const bodyAccountId = isPlainObject(body) ? readStringProperty(body, "accountId") : void 0;
+  const flagAccountId = typeof flags.account === "string" ? flags.account : void 0;
+  if (bodyAccountId && flagAccountId && bodyAccountId !== flagAccountId) throw new CliError("INVALID_VALUE", `Conflicting accountId: --account ${flagAccountId} vs data.accountId ${bodyAccountId}`, "Pass the same account once, either with --account or inside --data");
+  return mergeAccountId(body, flags);
+}
+function buildGoogleAssetGroupCreateBody(flags) {
+  if (typeof flags.data !== "string") throw new CliError("MISSING_FLAG", "Asset-group create requires `--data` for its assets", `Pass the full {"assetGroups":[...]} body, or combine --campaign, --name, and --final-url with --data '{"assets":[...]}'`);
+  const parsedData = parseDataFlag(flags, "Check JSON syntax in --data");
+  if (!isPlainObject(parsedData)) throw new CliError("INVALID_VALUE", "`--data` must be a JSON object", 'Use {"assetGroups":[...]} or a single asset-group object');
+  const explicitAssetGroups = readProperty(parsedData, "assetGroups");
+  if (Array.isArray(explicitAssetGroups)) return mergeGoogleAssetGroupAccountId(parsedData, flags);
+  const dataCampaignId = readStringProperty(parsedData, "campaignId");
+  const dataName = readStringProperty(parsedData, "name");
+  const dataFinalUrls = readProperty(parsedData, "finalUrls");
+  const campaignId = dataCampaignId ?? requireFlag(flags, "campaign", "Pass --campaign <id> or include campaignId in --data");
+  const name = dataName ?? requireFlag(flags, "name", "Pass --name or include name in --data");
+  const finalUrls = Array.isArray(dataFinalUrls) ? dataFinalUrls : [requireFlag(flags, "final-url", "Pass --final-url or include finalUrls in --data")];
+  const dataStatus = readProperty(parsedData, "status");
+  const status2 = dataStatus ?? (typeof flags.status === "string" ? flags.status : void 0);
+  const fragment = removeQueryOnlyBodyKeys(parsedData, ["accountId", "assetGroups"]);
+  const assetGroup = {
+    ...isPlainObject(fragment) ? fragment : {},
+    campaignId,
+    name,
+    finalUrls,
+    ...status2 === void 0 ? {} : { status: status2 }
+  };
+  const dataAccountId = readStringProperty(parsedData, "accountId");
+  const body = { ...dataAccountId ? { accountId: dataAccountId } : {}, assetGroups: [assetGroup] };
+  return mergeGoogleAssetGroupAccountId(body, flags);
+}
+function buildGoogleAssetGroupUpdateBody(flags) {
+  const body = {};
+  if (typeof flags.name === "string") body.name = flags.name;
+  if (flags.status === "enabled" || flags.status === "paused") body.status = flags.status;
+  else if (typeof flags.status === "string") throw new CliError("INVALID_VALUE", `Invalid asset group status: ${flags.status}`, "Use enabled or paused; use delete to remove the group");
+  if (typeof flags["final-url"] === "string") body.finalUrls = [flags["final-url"]];
+  if (Object.keys(body).length === 0) throw new CliError("MISSING_FLAG", "Asset-group update requires a change", "Pass --name, --status, --final-url, or --data with assets.add/assets.remove");
+  return body;
+}
 function inferGoogleMediaContentType(filename) {
   const extension = extname(filename).toLowerCase();
   if (extension === ".jpg" || extension === ".jpeg") return "image/jpeg";
@@ -2503,6 +2596,45 @@ async function deleteCampaign2(client, args, flags) {
   const path3 = `/manage/google/campaigns/${id}${qs}`;
   return client.delete(path3);
 }
+async function listGoogleAssetGroups(client, _args, flags) {
+  validateFlags(flags, ASSET_GROUP_LIST_FLAGS, "manage google asset-groups list");
+  const campaignId = requireFlag(flags, "campaign", "Run: adkit manage google asset-groups list --campaign <campaign-id>");
+  const qs = buildGoogleListQuery(flags, { campaignId });
+  return client.get(`/manage/google/asset-groups${qs}`);
+}
+async function getGoogleAssetGroup(client, args, flags) {
+  validateFlags(flags, ["raw"], "manage google asset-groups <id>");
+  const id = requireGoogleNumericId(args, "asset-group-id", "Run: adkit manage google asset-groups <asset-group-id>");
+  const qs = buildGoogleListQuery(flags);
+  return client.get(`/manage/google/asset-groups/${id}${qs}`);
+}
+async function createGoogleAssetGroup(client, _args, flags) {
+  validateFlags(flags, ASSET_GROUP_CREATE_FLAGS, "manage google asset-groups create");
+  const body = buildGoogleAssetGroupCreateBody(flags);
+  const qs = buildGoogleMutationQuery(flags, body);
+  return client.post(`/manage/google/asset-groups${qs}`, body);
+}
+async function updateGoogleAssetGroup(client, args, flags) {
+  validateFlags(flags, ASSET_GROUP_UPDATE_FLAGS, "manage google asset-groups update");
+  const id = requireGoogleNumericId(args, "asset-group-id", "Run: adkit manage google asset-groups update <asset-group-id> --data <json>");
+  if (typeof flags.data === "string") {
+    const parsedBody = parseDataFlag(flags, "Use assets.add and assets.remove for asset mutations");
+    if (!isPlainObject(parsedBody)) throw new CliError("INVALID_VALUE", "`--data` must be a JSON object", "Use an asset-group update object");
+    const scopedBody = mergeGoogleAssetGroupAccountId(parsedBody, flags);
+    const qs2 = buildGoogleMutationQuery(flags, scopedBody);
+    const body2 = removeQueryOnlyBodyKeys(scopedBody, ["accountId"]);
+    return client.patch(`/manage/google/asset-groups/${id}${qs2}`, body2);
+  }
+  const body = buildGoogleAssetGroupUpdateBody(flags);
+  const qs = buildGoogleMutationQuery(flags, body);
+  return client.patch(`/manage/google/asset-groups/${id}${qs}`, body);
+}
+async function deleteGoogleAssetGroup(client, args, flags) {
+  validateFlags(flags, [], "manage google asset-groups delete");
+  const id = requireGoogleNumericId(args, "asset-group-id", "Run: adkit manage google asset-groups delete <asset-group-id>");
+  const qs = buildGoogleMutationQuery(flags, {});
+  return client.delete(`/manage/google/asset-groups/${id}${qs}`);
+}
 async function listGoogleAdGroups(client, _args, flags) {
   validateFlags(flags, AD_GROUP_LIST_FLAGS, "manage google ad-groups list");
   const campaignId = typeof flags.campaign === "string" ? flags.campaign : void 0;
@@ -4622,7 +4754,7 @@ function isHelpSearchResponse(value) {
 var require2 = createRequire(import.meta.url);
 var CLI_VERSION = require2("../package.json").version;
 var DEFAULT_BASE_URL = "https://app.adkit.so/api/v1";
-var GOOGLE_NUMERIC_ID_PATTERN = /^\d+$/;
+var GOOGLE_NUMERIC_ID_PATTERN2 = /^\d+$/;
 var GOOGLE_RESULTS_LEVEL_ACTIONS = /* @__PURE__ */ new Set(["campaigns", "ad-groups", "ads"]);
 var TIKTOK_NUMERIC_ID_PATTERN = /^\d+$/;
 var LINKEDIN_ID_PATTERN = /[\d:_]/;
@@ -5326,7 +5458,7 @@ Note:
   Advanced geo examples: adkit manage google campaigns --help full
   Display creation starts here: campaigns create --campaign-type display, then create Display ad groups and responsive_display ads.
   Performance Max: campaignType "performance_max" with asset groups \u2014 build it with --data. See --help full.
-  View a Performance Max campaign by ID to read back its assetGroups from Google.
+  View a Performance Max campaign by ID to read back its assetGroups; manage existing groups with google asset-groups.
   For spend/clicks/conversions: adkit manage google results
 
 Examples:
@@ -5379,8 +5511,8 @@ Notes:
   platformLocation accepts exact Google geo objects for advanced criteria and existing raw values.
   Google exclusions support named locations. Proximity circles belong in include.
   Display campaign creation uses campaignType:"display" or --campaign-type display. Videos are not supported for Display media in v1.
-  Performance Max: campaignType "performance_max" with exactly one assetGroups[] entry. Text assets inline ({role,text}); image assets are uploaded via google media first, then referenced by id/resourceName. Needs an enabled conversion (publish is blocked without one). Non-retail only. Build it with --data.
-  View a Performance Max campaign by ID to read back assetGroups from Google. There is no separate google asset-groups command.
+  Performance Max: campaignType "performance_max" requires at least one assetGroups[] entry and supports multiple groups. Text assets are inline ({role,text}); upload images with google media first, then reference their id/resourceName. Needs an enabled conversion (publish is blocked without one). Non-retail only. Build it with --data.
+  View a Performance Max campaign by ID to read back its assetGroups. After creation, manage groups with google asset-groups.
   For spend/clicks/conversions: adkit manage google results
 
 Examples:
@@ -5393,6 +5525,58 @@ Examples:
   adkit manage google campaigns update 987654321 --status paused --account 1234567890
   adkit manage google campaigns update 987654321 --data '{"targeting":{"geoLocations":{"match":"presence_or_interest"}}}' --account 1234567890
   adkit manage google campaigns delete 987654321 --account 1234567890 --publish`;
+var GOOGLE_ASSET_GROUP_HELP = `adkit manage google asset-groups \u2014 Performance Max asset groups
+
+  list                List groups in one campaign (requires --campaign)
+  create              Create one group or a batch
+  update <id>         Update by numeric Google asset group ID (platformId)
+  delete <id>         Delete by numeric Google asset group ID (platformId)
+  <id>                View one group by numeric Google asset group ID (platformId)
+
+Flags (list):
+  --campaign <id>     Parent Performance Max campaign ID (required)
+  --limit <n>         Max results
+  --offset <n>        Pagination offset
+${FLAG.account}
+
+Flags (create):
+  --campaign <id>     Parent campaign ID for a single-group JSON fragment
+  --name <name>       Group name for a single-group JSON fragment
+  --status <s>        enabled or paused
+  --final-url <url>   Landing page for a single-group JSON fragment
+  --data <json>       Required assets. Pass a full {"assetGroups":[...]} body for batches, or one group fragment with assets when using the named flags
+${FLAG.account}
+${FLAG.publish}
+
+Flags (update):
+  --name <name>       New group name
+  --status <s>        enabled or paused; use delete to remove the group
+  --final-url <url>   Replace landing pages with one URL
+  --data <json>       Full update object. Use assets.add and assets.remove for asset changes
+${FLAG.account}
+${FLAG.publish}
+
+Asset JSON:
+  Text asset          {"role":"headline|long_headline|description|business_name","text":"..."}
+  Image asset         {"role":"marketing_image|square_marketing_image|logo|landscape_logo","id":"<uploaded-google-asset-id>"}
+  Remove asset        {"linkResourceName":"customers/.../assetGroupAssets/..."} \u2014 copy the exact value returned by list/get
+  Search theme        {"type":"search_theme","text":"..."} \u2014 create/read only; signals cannot be edited
+
+Notes:
+  Mutations create drafts by default. Add --publish to apply immediately.
+  Minimum per group: 3 headlines, 1 long_headline, 2 descriptions (at least one 60 characters or fewer), 1 business_name, 1 logo, 1 marketing_image, and 1 square_marketing_image.
+  list/get return assets grouped by role; every linked asset includes linkResourceName for later removal.
+  Upload images with google media before referencing their id or resourceName.
+  Creating groups for campaigns with Google brand guidelines enabled is not supported.
+
+Examples:
+  adkit manage google asset-groups list --campaign 987654321 --account 1234567890
+  adkit manage google asset-groups 555666777 --account 1234567890
+  adkit manage google asset-groups create --campaign 987654321 --name "US Prospects" --final-url https://example.com --data '{"assets":[{"role":"headline","text":"Ship faster"},{"role":"headline","text":"Save hours every week"},{"role":"headline","text":"Start free today"},{"role":"long_headline","text":"Automate your ad workflow"},{"role":"description","text":"Launch campaigns in minutes"},{"role":"description","text":"No credit card required"},{"role":"business_name","text":"Acme"},{"role":"logo","id":"111"},{"role":"marketing_image","id":"222"},{"role":"square_marketing_image","id":"333"}]}' --account 1234567890
+  adkit manage google asset-groups update 555666777 --name "US \u2014 refreshed" --account 1234567890
+  adkit manage google asset-groups update 555666777 --data '{"assets":{"add":[{"role":"headline","text":"New headline"}],"remove":[{"linkResourceName":"customers/1234567890/assetGroupAssets/555666777~444~HEADLINE"}]}}' --account 1234567890
+  adkit manage google asset-groups delete 555666777 --account 1234567890 --publish`;
+var GOOGLE_ASSET_GROUP_HELP_FULL = GOOGLE_ASSET_GROUP_HELP;
 var GOOGLE_AD_GROUP_HELP = `adkit manage google ad-groups \u2014 Google Ads ad groups
 
   list                List ad groups
@@ -6038,6 +6222,7 @@ Examples:
   adkit manage google accounts disconnect 1234567890`.trim(),
   "google assets": GOOGLE_ASSET_HELP,
   "google campaigns": GOOGLE_CAMPAIGN_HELP,
+  "google asset-groups": GOOGLE_ASSET_GROUP_HELP,
   "google ad-groups": GOOGLE_AD_GROUP_HELP,
   "google ads": GOOGLE_AD_HELP,
   "google keywords": GOOGLE_KEYWORD_HELP,
@@ -6487,6 +6672,7 @@ Run adkit manage meta <group> --help for details.`.trim(),
 Entity groups:
   accounts            List and connect Google Ads accounts
   campaigns           Manage Search, Display, and Performance Max campaigns
+  asset-groups        Manage Performance Max asset groups
   ad-groups           Manage ad groups and Display targeting
   ads                 Manage responsive search and Display ads
   keywords            Manage keywords and negatives \u2014 config only, not metrics
@@ -6839,6 +7025,7 @@ var HELP_FULL = {
   "meta lead-forms": LEAD_FORM_HELP,
   "google assets": GOOGLE_ASSET_HELP_FULL,
   "google campaigns": GOOGLE_CAMPAIGN_HELP_FULL,
+  "google asset-groups": GOOGLE_ASSET_GROUP_HELP_FULL,
   "google ad-groups": GOOGLE_AD_GROUP_HELP_FULL,
   "google ads": GOOGLE_AD_HELP_FULL,
   "google keywords": GOOGLE_KEYWORD_HELP_FULL,
@@ -6909,7 +7096,7 @@ function requireClient(flags, options = {}) {
   if (!apiKey) throw new CliError("NOT_AUTHENTICATED", "No API key found", "Run: adkit setup");
   const baseUrl = getBaseUrl();
   const projectId = options.projectOptional ? void 0 : selectedProject;
-  return new AdkitClient({ apiKey, baseUrl, clientVersion: CLI_VERSION, projectId });
+  return new AdkitClient({ apiKey, baseUrl, clientVersion: CLI_VERSION, projectId, readQueryFallback: flags.data });
 }
 function toPrintListDisplayRows(rows, isJson) {
   if (isJson) return rows;
@@ -8002,7 +8189,7 @@ async function main() {
                 data = await detachAsset(client, restArgs, flags);
                 break;
               default:
-                if (GOOGLE_NUMERIC_ID_PATTERN.test(action)) data = await getAsset(client, [action], flags);
+                if (GOOGLE_NUMERIC_ID_PATTERN2.test(action)) data = await getAsset(client, [action], flags);
                 else throw new CliError("UNKNOWN_COMMAND", `Unknown action: google assets ${action}`, "Run: adkit manage google assets --help");
             }
             break;
@@ -8041,11 +8228,36 @@ async function main() {
                 data = await deleteCampaign2(client, restArgs, flags);
                 break;
               default:
-                if (GOOGLE_NUMERIC_ID_PATTERN.test(action)) data = await getCampaign2(client, [action], flags);
+                if (GOOGLE_NUMERIC_ID_PATTERN2.test(action)) data = await getCampaign2(client, [action], flags);
                 else throw new CliError("UNKNOWN_COMMAND", `Unknown action: google campaigns ${action}`, "Run: adkit manage google campaigns --help");
             }
             break;
           }
+          case "asset-groups": {
+            if (!action) {
+              showHelp("google asset-groups", flags.help === "full");
+              return;
+            }
+            switch (action) {
+              case "list":
+                data = await listGoogleAssetGroups(client, restArgs, flags);
+                emptyHint = "No asset groups found in this campaign. Create one with `adkit manage google asset-groups create --help`.";
+                break;
+              case "create":
+                data = await createGoogleAssetGroup(client, restArgs, flags);
+                break;
+              case "update":
+                data = await updateGoogleAssetGroup(client, restArgs, flags);
+                break;
+              case "delete":
+                data = await deleteGoogleAssetGroup(client, restArgs, flags);
+                break;
+              default:
+                if (GOOGLE_NUMERIC_ID_PATTERN2.test(action)) data = await getGoogleAssetGroup(client, [action], flags);
+                else throw new CliError("UNKNOWN_COMMAND", `Unknown action: google asset-groups ${action}`, "Run: adkit manage google asset-groups --help");
+            }
+            break;
+          }
           case "ad-groups": {
             if (!action) {
               showHelp("google ad-groups", flags.help === "full");
@@ -8066,7 +8278,7 @@ async function main() {
                 data = await deleteAdGroup(client, restArgs, flags);
                 break;
               default:
-                if (GOOGLE_NUMERIC_ID_PATTERN.test(action)) data = await getAdGroup(client, [action], flags);
+                if (GOOGLE_NUMERIC_ID_PATTERN2.test(action)) data = await getAdGroup(client, [action], flags);
                 else throw new CliError("UNKNOWN_COMMAND", `Unknown action: google ad-groups ${action}`, "Run: adkit manage google ad-groups --help");
             }
             break;
@@ -8091,7 +8303,7 @@ async function main() {
                 data = await deleteAd2(client, restArgs, flags);
                 break;
               default:
-                if (GOOGLE_NUMERIC_ID_PATTERN.test(action)) {
+                if (GOOGLE_NUMERIC_ID_PATTERN2.test(action)) {
                   data = await getAd2(client, [action], flags);
                   detailEntity = "google-ad";
                 } else throw new CliError("UNKNOWN_COMMAND", `Unknown action: google ads ${action}`, "Run: adkit manage google ads --help");
@@ -8172,7 +8384,7 @@ async function main() {
                 break;
               }
               default:
-                if (GOOGLE_NUMERIC_ID_PATTERN.test(action)) data = await getKeyword(client, [action], flags);
+                if (GOOGLE_NUMERIC_ID_PATTERN2.test(action)) data = await getKeyword(client, [action], flags);
                 else throw new CliError("UNKNOWN_COMMAND", `Unknown action: google keywords ${action}`, "Run: adkit manage google keywords --help (includes negatives)");
             }
             break;
@@ -8244,7 +8456,7 @@ async function main() {
             break;
           }
           default:
-            throw new CliError("UNKNOWN_COMMAND", `Unknown entity: google ${entity}`, "Available: accounts, assets, media, campaigns, ad-groups, ads, keywords, conversions, results, change-history, research, geo-locations");
+            throw new CliError("UNKNOWN_COMMAND", `Unknown entity: google ${entity}`, "Available: accounts, assets, media, campaigns, asset-groups, ad-groups, ads, keywords, conversions, results, change-history, research, geo-locations");
         }
       } else if (platform2 === "tiktok") {
         switch (entity) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adkit/cli",
-  "version": "1.13.20",
+  "version": "1.13.21",
   "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",