GTM CLI [Wiki]

Tato stránka je pouze pro čtení. Můžete si pouze prohlédnout zdrojový kód, ale ne ho měnit. Zeptejte se správce, pokud si myslíte, že něco není v pořádku.
====== GTM CLI ======

[[https://www.owntag.eu/resources/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 [[https://github.com/owntag/gtm-cli|GitHubu]].

===== Co umí =====

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''

===== Instalace =====

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

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

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

<code bash>
npm install -g @owntag/gtm-cli
</code>

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

===== Autentizace a první spuštění =====

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

<code bash>
gtm auth login
gtm config setup
gtm accounts list
gtm tags list
</code>

Pro automatizaci lze použít service account:

<code bash>
gtm auth login --service-account /path/to/service-account-key.json
</code>

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

===== Typické příkazy =====

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

<code bash>
# 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
</code>

===== Automatizace a AI agenti =====

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

<code bash>
gtm tags list --output json
gtm tags list | jq '.[].name'
</code>

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:

<code bash>
gtm agent guide
</code>

===== Zdroje =====

  * [[https://www.owntag.eu/resources/gtm-cli/|owntag – GTM CLI]]
  * [[https://github.com/owntag/gtm-cli|GitHub: owntag/gtm-cli]]