@adkit/cli 1.12.15 → 1.12.17

package/dist/cli.js

@@ -1815,10 +1815,11 @@ 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", "limit", "offset"];
+var AD_LIST_FLAGS = ["ad-group", "status", "policy-status", "limit", "offset"];
 var AD_FLAGS2 = ["headline", "headline-1", "headline-2", "headline-3", "description", "description-1", "description-2", "callout", "sitelink", "final-url", "path", "ad-group", "status"];
 var KEYWORD_LIST_FLAGS = ["ad-group", "campaign", "status", "limit", "offset"];
 var KEYWORD_FLAGS = ["ad-group", "text", "match-type", "cpc-bid", "status"];
@@ -1860,16 +1861,23 @@ function resolveGoogleAdGroupId(body, flags) {
 function buildGoogleListQuery(flags, extra = {}) {
   const accountId = typeof flags.account === "string" ? flags.account : void 0;
   const status2 = typeof flags.status === "string" ? flags.status : void 0;
+  const policyStatus = typeof flags["policy-status"] === "string" ? flags["policy-status"] : void 0;
   const limit = typeof flags.limit === "string" ? flags.limit : void 0;
   const offset = typeof flags.offset === "string" ? flags.offset : void 0;
   const raw = flags.raw === true ? "true" : void 0;
-  return queryString({ accountId, status: status2, limit, offset, raw, ...extra });
+  return queryString({ accountId, status: status2, policyStatus, limit, offset, raw, ...extra });
 }
 function buildGoogleMutationQuery(flags, body, extra = {}) {
   const accountId = resolveGoogleAccountId(body, flags);
   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;
@@ -1969,11 +1977,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;
 }
@@ -2283,7 +2310,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);
@@ -2299,15 +2326,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);
 }
@@ -2457,19 +2486,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");
@@ -2692,8 +2723,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];
@@ -2954,7 +2985,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);
@@ -2963,7 +2994,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);
@@ -3668,6 +3699,7 @@ function toGoogleAdDisplayRow(ad) {
     ID: ad.platformId ?? "-",
     "AD GROUP": ad.adGroupId ?? "-",
     STATUS: ad.status ?? "-",
+    POLICY: ad.policyStatus ?? "-",
     HEADLINES: formatGoogleAssetsForCli(ad.headlines, "headline"),
     DESCRIPTIONS: formatGoogleAssetsForCli(ad.descriptions, "description"),
     URLS: Array.isArray(ad.finalUrls) && ad.finalUrls.length > 0 ? ad.finalUrls.join(" | ") : "-"
@@ -3684,7 +3716,7 @@ function normalizeGoogleCliPath(path3) {
   return void 0;
 }
 function toGoogleAdDetailLines(ad) {
-  const metadataLines = [`  Ad ID:        ${String(ad.platformId ?? "-")}`, `  Ad Group:     ${String(ad.adGroupId ?? "-")}`, `  Status:       ${ad.status ?? "-"}`];
+  const metadataLines = [`  Ad ID:        ${String(ad.platformId ?? "-")}`, `  Ad Group:     ${String(ad.adGroupId ?? "-")}`, `  Status:       ${ad.status ?? "-"}`, `  Policy:       ${ad.policyStatus ?? "-"}`];
   const lines = ["", ...metadataLines];
   const headlines = formatGoogleAssetsForCli(ad.headlines, "headline");
   const descriptions = formatGoogleAssetsForCli(ad.descriptions, "description");
@@ -4631,6 +4663,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)
@@ -4677,6 +4710,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}
@@ -4804,6 +4838,7 @@ Flags (create/update):
 Flags (list):
   --ad-group <id>        Filter by Google ad group ID (platformId)
   --status <s>           Filter by ad status (default: enabled,paused; use all for every status)
+  --policy-status <s>    Filter by policy status: approved, limited, disapproved, problem, pending_review, under_appeal
   --limit <n>            Max results
   --offset <n>           Pagination offset
 
@@ -4815,6 +4850,7 @@ Notes:
   Upload images first with google media upload, then use returned Google asset id/resourceName in media[].id.
   Display videos are not supported in v1.
   Display support is in beta \u2014 some features may not be available yet. Report issues with: adkit feedback "description" --type bug
+  list/get return policyStatus when Google returns policy review data. policyIssues appears only for blocked/limited/review ads or when filtering by --policy-status.
   Ad-level callout/sitelink input is an AdKit convenience layer. On publish, AdKit creates or reuses reusable Google assets, then attaches them at ad-group scope.
   That means sibling ads in the same ad group may also use those assets. Use google assets if you need explicit scope control or richer sitelink payloads.
 
@@ -4856,6 +4892,7 @@ ${FLAG.data}
 Flags (list):
   --ad-group <id>        Filter by Google ad group ID (platformId)
   --status <s>           Filter by ad status (default: enabled,paused; use all for every status)
+  --policy-status <s>    Filter by policy status: approved, limited, disapproved, problem, pending_review, under_appeal
   --limit <n>            Max results
   --offset <n>           Pagination offset
 
@@ -4868,6 +4905,7 @@ Notes:
   Media refs are existing Google image asset IDs/resourceNames returned by google media upload.
   Display videos are not supported in v1.
   Display support is in beta \u2014 some features may not be available yet. Report issues with: adkit feedback "description" --type bug
+  list/get return policyStatus when Google returns policy review data. policyIssues appears only for blocked/limited/review ads or when filtering by --policy-status.
   Ad-level callout/sitelink input is stored on the ad draft, but Google serves these assets at ad-group scope. AdKit resolves, de-duplicates, and attaches them there on publish.
   Use google assets for explicit scope control, reusable libraries, account/campaign-level associations, or richer sitelink payloads via --data.
   Path format: pass one string like "crm" or "crm/demo". AdKit normalizes extra slashes, and each segment must stay within Google's 15-character limit.
@@ -4912,6 +4950,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
 
@@ -4953,6 +4992,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
 

package/package.json

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