GTM CLI

GTM CLI je open-source příkazová řádka pro správu Google Tag Manageru mimo webové rozhraní. Hodí se hlavně pro automatizaci, CI/CD a skriptovatelné operace nad kontejnery, workspace, tagy, triggery, proměnnými a verzemi. Zdrojový kód je dostupný na GitHubu.

Podle dokumentace projektu a README repozitáře nabízí hlavně:

• správu GTM účtů, kontejnerů, workspace, tagů, triggerů, proměnných, verzí, prostředí, složek a uživatelských oprávnění
• podporu pro server-side GTM resource jako klienti, šablony, transformace, zóny, destinations a gtag configs
• OAuth i přihlášení přes service account
• více výstupních formátů: table, json a compact
• shell completion pro bash, zsh a fish
• vestavěnou nápovědu pro AI asistenty přes příkaz gtm agent guide

Dokumentace doporučuje rychlou instalaci přes instalační skript:

curl -fsSL https://raw.githubusercontent.com/owntag/gtm-cli/main/install.sh | bash

Alternativně lze použít instalaci přes npm, což se hodí hlavně pro CI/CD workflow a pinování verze:

npm install -g @owntag/gtm-cli

README zároveň uvádí, že nativní Windows podpora zatím není a doporučená cesta je WSL.

Základní interaktivní přihlášení probíhá přes OAuth:

gtm auth login
gtm config setup
gtm accounts list
gtm tags list

Pro automatizaci lze použít service account:

gtm auth login --service-account /path/to/service-account-key.json

Podle README se OAuth credentials ukládají do ~/.config/gtm-cli/credentials.json. Pro service account lze použít i standardní proměnnou prostředí GOOGLE_APPLICATION_CREDENTIALS.

Tady je několik praktických příkladů přímo z dokumentace:

# seznam účtů
gtm accounts list
 
# seznam kontejnerů v účtu
gtm containers list --account-id 123456789
 
# seznam workspace
gtm workspaces list
 
# seznam tagů
gtm tags list
 
# vytvoření nové verze
gtm versions create --name "v1.0" --notes "Initial release"
 
# publikace verze
gtm versions publish --version-id 42

Projekt je navržený tak, aby dobře fungoval jak v shell skriptech, tak v AI workflow. V terminálu používá standardně tabulkový výstup, při rourách nebo explicitní volbě umí vracet JSON, což se hodí pro další zpracování.

gtm tags list --output json
gtm tags list | jq '.[].name'

README výslovně zmiňuje použití v CI/CD pipelines a také to, že CLI obsahuje vlastní průvodce pro AI agenty dostupného přes:

gtm agent guide

• owntag – GTM CLI
• GitHub: owntag/gtm-cli