@koda-sl/baker-cli 0.137.0-dev.c9486c01e → 0.138.0
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 +7 -1
- package/dist/{chunk-TXNOPO6P.js → chunk-TAGQCU36.js} +4 -4
- package/dist/chunk-TAGQCU36.js.map +1 -0
- package/dist/cli.js +97 -22
- package/dist/cli.js.map +1 -1
- package/dist/engine/index.js +1 -1
- package/package.json +1 -1
- package/dist/chunk-TXNOPO6P.js.map +0 -1
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
|
-
//
|
|
10
|
+
// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/node_modules/safe-stable-stringify/index.js
|
|
11
11
|
var require_safe_stable_stringify = __commonJS({
|
|
12
|
-
"
|
|
12
|
+
"../../node_modules/.pnpm/safe-stable-stringify@2.5.0/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
|
-
//
|
|
1073
|
+
// ../../node_modules/.pnpm/safe-stable-stringify@2.5.0/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-
|
|
7840
|
+
//# sourceMappingURL=chunk-TAGQCU36.js.map
|