360 Secure SkillHub
360 安全技能中心

Google Tag Manager

提供 Bash 脚本封装 Google Tag Manager API v2，用服务账号鉴权后可列出账户与容器、增删改查标签/触发器/变量、查看与启用内置变量、创建并发布容器版本；附 JSON 模板与 API 参考，工作区默认自动解析。

simonfunk
simonfunk
热度 66.95
最近更新 2026-05-18 12:03:51
分类：营销依赖：代码执行 / 第三方 API / 读写文件应用场景：API 集成 / 自动化脚本 / 工作流 / 模板

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add google-tag-manager
Metadata
name
google-tag-manager
description
Manage Google Tag Manager containers, tags, triggers, variables, and versions via the GTM API v2. Use when the user wants to list, create, update, delete, or inspect GTM tags, triggers, variables, built-in variables, workspaces, or versions. Also use for publishing container versions, auditing GTM setups, creating conversion tags, setting up cross-domain tracking, or managing dataLayer events. Covers: "GTM", "Tag Manager", "container tag", "conversion tag", "trigger", "GTM variable", "publish GTM", "GTM workspace", "dataLayer", "Google Ads tag", "GA4 tag", "cross-domain tracking".
metadata
{"env":[{"GTM_ACCOUNT_ID":"GTM account ID (numeric). Find at tagmanager.google.com."},{"GTM_CONTAINER_ID":"GTM container ID (numeric)."},{"GOOGLE_APPLICATION_CREDENTIALS":"Path to service account JSON key file with Tag Manager API access."}]}

Google Tag Manager Skill

Interact with the GTM API v2 to manage containers, workspaces, tags, triggers, variables, and versions.

Authentication

The GTM API uses OAuth2 via a Google Cloud service account.

Setup

  1. Enable Tag Manager API in Google Cloud Console
  2. Create a service account with key (JSON)
  3. Grant the service account access in GTM (Admin → User Management → add service account email)
  4. Set env vars:
    • GOOGLE_APPLICATION_CREDENTIALS=/path/to/service-account.json
    • GTM_ACCOUNT_ID=123456
    • GTM_CONTAINER_ID=789012

Script

All operations use scripts/gtm.sh. Run without args to see usage:

scripts/gtm.sh <command> [args...]

Commands

Command Description
accounts List all GTM accounts
containers [accountId] List containers in account
workspaces List workspaces in container
tags [workspaceId] List tags in workspace (default: latest)
tag <tagId> [workspaceId] Get a specific tag
create-tag <jsonFile> [workspaceId] Create a tag from JSON
update-tag <tagId> <jsonFile> [workspaceId] Update a tag
delete-tag <tagId> [workspaceId] Delete a tag
triggers [workspaceId] List triggers
trigger <triggerId> [workspaceId] Get a specific trigger
create-trigger <jsonFile> [workspaceId] Create a trigger from JSON
update-trigger <triggerId> <jsonFile> [workspaceId] Update a trigger
delete-trigger <triggerId> [workspaceId] Delete a trigger
variables [workspaceId] List variables
variable <variableId> [workspaceId] Get a specific variable
create-variable <jsonFile> [workspaceId] Create a variable from JSON
update-variable <variableId> <jsonFile> [workspaceId] Update a variable
delete-variable <variableId> [workspaceId] Delete a variable
built-in-vars [workspaceId] List enabled built-in variables
enable-built-in <type,...> [workspaceId] Enable built-in variable(s)
versions List container version headers
version <versionId> Get a specific version
version-live Get the live (published) version
create-version [workspaceId] [name] [notes] Create version from workspace
publish <versionId> Publish a container version

Workspace Resolution

Most commands accept an optional workspaceId. If omitted, the script auto-resolves to the Default Workspace (the first workspace returned by the API — typically "Default Workspace").

Common Recipes

Create a Google Ads Conversion Tag

See references/recipes.md for JSON templates for:

  • Google Ads Conversion Tracking tag
  • GA4 Event tag
  • Custom Event trigger (dataLayer)
  • Cross-domain tracking linker

Workflow: Add Tag → Create Version → Publish

# 1. Create trigger
scripts/gtm.sh create-trigger trigger.json

# 2. Create tag referencing the trigger
scripts/gtm.sh create-tag tag.json

# 3. Create version from workspace
scripts/gtm.sh create-version "" "v1.2 - Added conversion tag"

# 4. Publish
scripts/gtm.sh publish <versionId>

API Reference

For full resource schemas and trigger types, see references/api-reference.md.