@adkit/cli 1.12.14 → 1.12.16

package/dist/cli.js

@@ -1818,7 +1818,7 @@ 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 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,10 +1860,11 @@ 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);
@@ -3668,6 +3669,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 +3686,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");
@@ -4804,6 +4806,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 +4818,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 +4860,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 +4873,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.
@@ -5043,7 +5049,7 @@ Flags:
   --sort <field>      Sort by: cost, clicks, impressions, conversions (default: cost)
   --limit <n>         Max results
   --status <s>        Filter: enabled, paused, all
-  --breakdown <b>     Split rows by: day, device, network. For campaign/ad-group/ad rows, use the level subcommands above.
+  --breakdown <b>     Split rows by: day, device, network, hour, geo. Hour/geo support account, campaigns, ad-groups.
   --fields <list>     Response fields, e.g. cost,clicks,searchImpressionShare. Omit for default advertiser metrics; use all for every supported field.
   --raw               Return raw Google API response
   --account <id>      Optional if one Google Ads account is connected
@@ -5056,7 +5062,8 @@ Visibility fields:
   Search: searchImpressionShare, searchRankLostImpressionShare, searchBudgetLostImpressionShare,
           searchTopImpressionShare, searchAbsoluteTopImpressionShare, searchClickShare (default where supported)
   Content: contentImpressionShare, contentRankLostImpressionShare, contentBudgetLostImpressionShare (use --fields all)
-  Note: search fields available at all levels except ads. Content fields not available at keywords or ads.
+  Note: search fields available at all levels except ads, but searchBudgetLostImpressionShare is not available for keywords.
+        Content fields not available at keywords or ads.
 
 Examples:
   adkit manage google results
@@ -5067,6 +5074,8 @@ Examples:
   adkit manage google results --campaign 123 --period 7d
   adkit manage google results --campaign 123 --period 7d --breakdown day
   adkit manage google results --campaign 123 --period 7d --breakdown device
+  adkit manage google results campaigns --period 7d --breakdown hour
+  adkit manage google results campaigns --period 30d --breakdown geo
   adkit manage google results placements --campaign 123 --period 30d
   adkit manage google results --period this_month --sort clicks --limit 20
   adkit manage google results search-terms --campaign 123 --period 30d

package/package.json

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