@koda-sl/baker-cli 0.137.0 → 0.138.0-dev.29e3414e1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -168,9 +168,12 @@ Run arbitrary GAQL queries. The most powerful command.
168
168
  # Raw GAQL
169
169
  baker ads google query "SELECT campaign.name, metrics.clicks, metrics.cost_micros FROM campaign WHERE segments.date DURING LAST_7_DAYS AND campaign.status = 'ENABLED' ORDER BY metrics.cost_micros DESC" --customer-id 1234567890
170
170
 
171
- # Use a preset (saves tokens)
171
+ # Use a preset (saves tokens) — returns only actually-serving entities by default
172
172
  baker ads google query --preset campaign-performance --customer-id 1234567890
173
173
 
174
+ # Include paused entities too (default is serving-only)
175
+ baker ads google query --preset ad-copy-performance --customer-id 1234567890 --include-paused
176
+
174
177
  # Export to CSV
175
178
  baker ads google query --preset search-terms --customer-id 1234567890 --out results.csv
176
179
 
@@ -226,6 +229,7 @@ baker ads google query --list-presets
226
229
  | `--customer-id` | Google Ads customer ID (10 digits, no dashes). Falls back to `BAKER_GOOGLE_ADS_CUSTOMER_ID` env var. |
227
230
  | `--preset` | Named query template (see presets below) |
228
231
  | `--date-range` | Override preset date range (LAST_7_DAYS, LAST_30_DAYS, etc.) |
232
+ | `--include-paused` | Include paused entities in preset results. Off by default: presets return only actually-serving entities (enabled campaign **and** ad group **and** ad). Google Ads has no single serving flag, so the whole chain must be `ENABLED` for an entity to serve. |
229
233
  | `--limit` | Max rows per page (default 200) |
230
234
  | `--cursor` | Pagination cursor from previous response |
231
235
  | `--all` | Auto-paginate all results |
@@ -251,6 +255,8 @@ baker ads google query --list-presets
251
255
  | `shopping-products` | Product-level shopping metrics | LAST_30_DAYS |
252
256
  | `account-summary` | Account-level totals | LAST_30_DAYS |
253
257
 
258
+ Every preset except the negatives lists and `account-summary` filters to **actually-serving entities** by default — the full status chain (`campaign.status = 'ENABLED' AND ad_group.status = 'ENABLED' AND ad_group_ad.status = 'ENABLED'`, as applicable) — and selects the status columns so you can see them. Pass `--include-paused` to widen to `!= 'REMOVED'` (keeps paused, still drops removed). Raw GAQL (no `--preset`) has no such default: a query over a serving-hierarchy resource without a status filter emits a `SERVING_SCOPE` warning reminding you to add the chain, because Google Ads has no single serving flag.
259
+
254
260
  **Pre-flight checks and auto-fixes:**
255
261
 
256
262
  The CLI rejects or automatically corrects common GAQL mistakes before hitting the API:
@@ -7,9 +7,9 @@ import {
7
7
  __toESM
8
8
  } from "./chunk-RK67WL4O.js";
9
9
 
10
- // ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js
10
+ // ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/810146e81bae4e3a061fe487864f2fde80c4b03b886877dc0f1fffbc6480b67e/node_modules/safe-stable-stringify/index.js
11
11
  var require_safe_stable_stringify = __commonJS({
12
- "../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js"(exports, module) {
12
+ "../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/810146e81bae4e3a061fe487864f2fde80c4b03b886877dc0f1fffbc6480b67e/node_modules/safe-stable-stringify/index.js"(exports, module) {
13
13
  "use strict";
14
14
  var { hasOwnProperty } = Object.prototype;
15
15
  var stringify = configure2();
@@ -1070,7 +1070,7 @@ function resolveAdaptFormats(params) {
1070
1070
  return params.formats ?? [];
1071
1071
  }
1072
1072
 
1073
- // ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/esm/wrapper.js
1073
+ // ../../.pnpm-store/v10/links/@/safe-stable-stringify/2.5.0/810146e81bae4e3a061fe487864f2fde80c4b03b886877dc0f1fffbc6480b67e/node_modules/safe-stable-stringify/esm/wrapper.js
1074
1074
  var import__ = __toESM(require_safe_stable_stringify(), 1);
1075
1075
  var configure = import__.default.configure;
1076
1076
  var wrapper_default = import__.default;
@@ -7837,4 +7837,4 @@ export {
7837
7837
  defaultRegistry,
7838
7838
  createEngineFromEnv
7839
7839
  };
7840
- //# sourceMappingURL=chunk-TAGQCU36.js.map
7840
+ //# sourceMappingURL=chunk-TXNOPO6P.js.map