Reference

`gog adsense reports query`

gog adsense reports query

Generated from gog schema --json. Do not edit this page by hand; run make docs-commands.

Run an AdSense report

#Usage

gog adsense reports (report) query (run,generate) <account> [flags]

#Parent

#Flags

FlagTypeDefaultHelp
--access-tokenstringUse provided access token directly (bypasses stored refresh tokens; token expires in ~1h)
-a
--account
--acct
stringAccount email, alias, or auto for authenticated Google API commands
--clientstringOAuth client name (selects stored credentials + token bucket)
--colorstringautoColor output: auto|always|never
--currencystringCurrency code override (e.g. USD)
--date-rangestringLAST_7_DAYSNamed date range (TODAY,YESTERDAY,MONTH_TO_DATE,YEAR_TO_DATE,LAST_7_DAYS,LAST_30_DAYS); ignored if --from/--to set
--dimensionsstringDATEComma-separated report dimensions (e.g. DATE,COUNTRY_NAME)
--disable-commandsstringComma-separated list of disabled commands; dot paths allowed
-n
--dry-run
--dryrun
--noop
--preview
boolDo not make changes; print intended actions and exit successfully
--enable-commandsstringComma-separated list of enabled command prefixes; dot paths allowed (restricts CLI)
--enable-commands-exactstringComma-separated list of exact enabled commands; dot paths allowed and parent commands do not enable children
--fail-empty
--non-empty
--require-results
boolExit with code 3 if no rows
--filter[]stringReport filter, repeatable, passed through to the API (e.g. COUNTRY_NAME==United States)
-y
--force
--assume-yes
--yes
boolSkip confirmations for destructive commands
--from
--start
stringStart date (YYYY-MM-DD); combine with --to for a custom range
--gmail-no-sendboolfalseBlock Gmail send operations (agent safety)
-h
--help
kong.helpFlagShow context-sensitive help.
--homestringOverride gogcli config/data/state/cache root (equivalent to GOG_HOME)
-j
--json
--machine
boolfalseOutput JSON to stdout (best for scripting)
--languagestringLanguage code for headers (e.g. en-US)
--max
--limit
int64Max rows to return
--metricsstringESTIMATED_EARNINGS,CLICKS,IMPRESSIONSComma-separated report metrics (e.g. ESTIMATED_EARNINGS,CLICKS,IMPRESSIONS)
--no-input
--non-interactive
--noninteractive
boolNever prompt; fail instead (useful for CI)
--order-by[]stringSort order, repeatable (e.g. -DATE for descending)
-p
--plain
--tsv
boolfalseOutput stable, parseable text to stdout (TSV; no colors)
--quota-projectstringGoogle Cloud project to bill for API usage (sent as X-Goog-User-Project; some APIs require it with --access-token or ADC)
--readonlyboolfalseBlock mutating API requests at runtime; auth add also requests read-only OAuth scopes
--results-onlyboolIn JSON mode, emit only the primary result (drops envelope fields like nextPageToken)
--select
--pick
--project
stringIn JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands.
--timezonestringReporting timezone: ACCOUNT_TIME_ZONE (default) or GOOGLE_TIME_ZONE (America/Los_Angeles)
--to
--end
stringEnd date (YYYY-MM-DD); combine with --from for a custom range
-v
--verbose
boolEnable verbose logging
--versionkong.VersionFlagPrint version and exit
--wrap-untrustedboolfalseIn JSON/raw output, wrap fetched text fields in external untrusted-content markers

#See Also