Schnellstart
1. Authentifizieren
# Interaktiver OAuth-Login (öffnet Browser)
gtm auth login
# Oder Service Account für Automatisierung nutzen
gtm auth login --service-account path/to/key.json
2. Defaults setzen (optional)
# Standard-Account/Container konfigurieren
gtm config setup
3. GTM verwalten
# Konten auflisten
gtm accounts list
# Container eines Kontos auflisten
gtm containers list --account-id 123456
# Alle Tags im Workspace auflisten
gtm tags list
# Bestimmten Tag abrufen
gtm tags get --tag-id 42
Häufige Anwendungsfälle
Tags verwalten
# Alle Tags auflisten
gtm tags list
# Neuen Tag erstellen
gtm tags create --name "GA4 Event" --type gaawe --config '{"parameter": [...]}'
# Tag aktualisieren
gtm tags update --tag-id 42 --name "New Name"
# Tag löschen
gtm tags delete --tag-id 42 --force
Versionskontrolle
# Neue Version erstellen
gtm versions create --name "v1.0" --notes "Initial release"
# Aktuelle Live-Version abrufen
gtm versions live
# Version veröffentlichen
gtm versions publish --version-id 42
Workspace-Verwaltung
# Workspaces auflisten
gtm workspaces list
# Neuen Workspace erstellen
gtm workspaces create --name "Feature Branch"
# Workspace-Status prüfen (ausstehende Änderungen)
gtm workspaces status --workspace-id 1
# Workspace mit Live-Version synchronisieren
gtm workspaces sync --workspace-id 1
Server-Side GTM
GTM CLI unterstützt serverseitige GTM-Ressourcen vollständig:
# Clients verwalten
gtm clients list
gtm clients create --name "GA4 Client" --type gaaw_client
# Templates verwalten
gtm templates list
# Transformations verwalten
gtm transformations list
Ausgabeformate
GTM CLI passt sich deinem Workflow an:
# Tabellenausgabe (Standard im Terminal)
gtm tags list --output table
# JSON-Ausgabe (Standard beim Pipen)
gtm tags list --output json
# Kompakte Ausgabe (nur IDs und Namen)
gtm tags list --output compact
# An andere Tools pipen
gtm tags list | jq '.[].name'
CI/CD-Integration
GTM CLI glänzt in automatisierten Workflows. Hier ein Beispiel für GitHub Actions:
jobs:
deploy-gtm:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- name: Install GTM CLI
run: |
curl -fsSL https://raw.githubusercontent.com/owntag/gtm-cli/main/install.sh | bash
- name: Deploy to GTM
env:
GOOGLE_APPLICATION_CREDENTIALS: ${{ secrets.GTM_SERVICE_ACCOUNT_KEY }}
run: |
# Neue Version erstellen und veröffentlichen
gtm versions create --name "Deploy ${{ github.sha }}"
gtm versions publish --version-id $(gtm version-headers list --output json | jq -r '.[0].containerVersionId')
Fragen oder Feedback? Öffne ein Issue auf GitHub – wir freuen uns über deine Nachricht!