概述

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

Enable Tag Manager API in Google Cloud Console
Create a service account with key (JSON)
Grant the service account access in GTM (Admin → User Management → add service account email)
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 [workspaceId]`	Get a specific tag
`create-tag [workspaceId]`	Create a tag from JSON
`update-tag [workspaceId]`	Update a tag
`delete-tag [workspaceId]`	Delete a tag
`triggers [workspaceId]`	List triggers
`trigger [workspaceId]`	Get a specific trigger
`create-trigger [workspaceId]`	Create a trigger from JSON
`update-trigger [workspaceId]`	Update a trigger
`delete-trigger [workspaceId]`	Delete a trigger
`variables [workspaceId]`	List variables
`variable [workspaceId]`	Get a specific variable
`create-variable [workspaceId]`	Create a variable from JSON
`update-variable [workspaceId]`	Update a variable
`delete-variable [workspaceId]`	Delete a variable
`built-in-vars [workspaceId]`	List enabled built-in variables
`enable-built-in [workspaceId]`	Enable built-in variable(s)
`versions`	List container version headers
`version`	Get a specific version
`version-live`	Get the live (published) version
`create-version [workspaceId] [name] [notes]`	Create version from workspace
`publish`	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.

版本历史

共 1 个版本

v1.0.0 当前

2026-03-29 07:39 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)