lucianfialho/gmp-cli/gmp-gtm

gtm (Google Tag Manager API v2)

PREREQUISITE: Read ../gmp-shared/SKILL.md for auth, global flags, and output formats.

gmp gtm <command> [flags]

Commands

Quick Reference

List accounts and containers

gmp gtm accounts
gmp gtm containers -a ACCOUNT_ID

List tags, triggers, and variables

# Uses default workspace automatically
gmp gtm tags -p accounts/X/containers/Y -f table
gmp gtm triggers -p accounts/X/containers/Y -f table
gmp gtm variables -p accounts/X/containers/Y -f table
 
# Specific workspace
gmp gtm tags -p accounts/X/containers/Y -w 3 -f table

List published versions

gmp gtm versions -p accounts/X/containers/Y -f table
gmp gtm versions -p accounts/X/containers/Y -l 5 -f table

Container Path Format

All tag/trigger/variable/version commands require a container path:

accounts/{ACCOUNT_ID}/containers/{CONTAINER_ID}

Get the account ID from gmp gtm accounts and container ID from gmp gtm containers -a ACCOUNT_ID.

Workspace Behavior

• Default: -w 0 uses the "Default Workspace" automatically.
• Specify -w <ID> for a specific workspace.
• The CLI resolves the default workspace by listing workspaces and picking "Default Workspace" or the first available.

Output Columns

Table and CSV output is simplified. JSON output includes full API fields — use -f json for audits and automation.

Tags (-f table)

Tags (-f json — additional fields)

Triggers (-f table)

Triggers (-f json — additional fields)

Variables (-f table)

Variables (-f json — additional fields)

Tips

• Get the container path from gmp gtm containers -a ACCOUNT_ID -- use the path column.
• Tags, triggers, and variables are workspace-scoped. Use -w 0 for the default workspace.
• Use gmp gtm versions to see publish history and compare tag/trigger/variable counts across versions.
• Pipe to jq for analysis: gmp gtm tags ... -f json | jq '[.[] | select(.type == "html")]'
• Unused variable audit: extract all {{VarName}} references from parameter[].value across tags, triggers, and variables, then diff against the variables list.

# Find all variable references used in tags
gmp gtm tags -p accounts/X/containers/Y -f json \
  | jq -r '[.[].parameter[]? | .. | strings | scan("\\{\\{([^}]+)\\}\\}")][] ' \
  | sort -u