gmp-gtm

Files (1)

• SKILL.md

SKILL.md (first lines)

# gtm (Google Tag Manager API v2)

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

```bash
gmp gtm <command> [flags]
```

## Commands

| Command | Description |
|---------|-------------|
| `accounts` | List GTM accounts |
| `containers` | List containers for an account |
| `tags` | List tags in a container workspace |
| `triggers` | List triggers in a container workspace |
| `variables` | List variables in a container workspace |
| `versions` | List published container versions |

## Quick Reference

### List accounts and containers

```bash
gmp gtm accounts
gmp gtm containers -a ACCOUNT_ID
```

### List tags, triggers, and variables

```bash
# 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

```bash
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`)
| Column | Description |
|--------|-------------|
| `tagId` | Tag ID |
| `name` | Tag name |
| `type` | Tag type (e.g. `ua`, `awct`, `html`, `gaawe`) |
| `firingTriggerId` | Comma-separated trigger IDs |
| `paused` | Whether the tag is paused |

### Tags (`-f json` — additional fields)
| Field | Description |
|-------|-------------|
| `parameter` | Full parameter array (measurementId, eventName, eventParameters, etc.) |
| `blockingTriggerId` | Array of blocking trigger IDs |
| `fingerprint` | Tag fingerprint |
| `path` | Full resource path |

### Triggers (`-f table`)
| Column | Description |
|--------|-------------|
| `triggerId` | Trigger ID |
| `name` | Trigger name |
| `type` | Trigger type (e.g. `pageview`, `click`, `customEvent`) |

### Triggers (`-f json` — additional fields)
| Field | Description |
|-------|-------------|
| `filter` | Trigger condition filters |
| `autoEventFilter` | Auto-event filters |
| `parameter` | Trigger parameter array |
| `fingerprint` | Trigger fingerprint |
| `path` | Full resource path |

### Variables (`-f table`)
| Column | Description |
|--------|-------------|
| `variableId` | Variable ID |
| `name` | Variable name |
| `type` | Variable type (e.g. `v`, `jsm`, `gas`) |

### Variables (`-f json` — additional fields)
| Field | Description |
|-------|-------------|
| `parameter` | Variable parameter array |
| `fingerprint` | Variable fingerprint |
| `path` | Full resource path |

## 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.

From lucianfialho/gmp-cli, Apache-2.0.

More from lucianfialho/gmp-cli