Herramientas de Tag Manager
Contenedores, espacios de trabajo, etiquetas, activadores, variables, publicación de versiones y reversión.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.
Herramientas de lectura10 herramientas
list_gtm_accounts
Lectura1 créditosCuentas de Google Tag Manager a las que puede acceder el usuario de Google conectado (id de cuenta, nombre, ruta) y el contenedor seleccionado, si lo hay. Solo lectura.
Esta herramienta no recibe parámetros.
gtm_workspace_status
Lectura1 créditosLo que espera publicarse en un espacio de trabajo de GTM: cada etiqueta/activador/variable añadida, actualizada o eliminada y los conflictos de combinación, con recuentos. Compruébalo antes de publish_gtm_version. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
workspaceOpcional | string | id o nombre del espacio de trabajo; por defecto: Default Workspace |
list_gtm_containers
Lectura1 créditosCuentas y contenedores de Google Tag Manager a los que puede acceder el usuario de Google conectado (id, id público GTM-XXXX, nombre). Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | — |
list_gtm_workspaces
Lectura1 créditosEspacios de trabajo de un contenedor GTM. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
list_gtm_tags
Lectura1 créditosEtiquetas de un espacio de trabajo GTM con tipo, parámetros y activadores; marca las etiquetas sin activador (nunca se disparan) y las pausadas. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
workspaceOpcional | string | id o nombre del espacio de trabajo; por defecto: Default Workspace |
list_gtm_triggers
Lectura1 créditosActivadores de un espacio de trabajo GTM con tipo y condiciones. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
workspaceOpcional | string | id o nombre del espacio de trabajo; por defecto: Default Workspace |
list_gtm_variables
Lectura1 créditosVariables definidas por el usuario y variables integradas habilitadas en un espacio de trabajo GTM. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
workspaceOpcional | string | id o nombre del espacio de trabajo; por defecto: Default Workspace |
list_gtm_versions
Lectura1 créditosVersiones del contenedor (la más reciente primero) y la versión publicada actualmente. Úsalo antes de revert_gtm_version. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
limitOpcional | integer (1–100) | — |
detailsOpcional | boolean | also list tag/trigger/variable names of the newest 10 versions |
list_gtm_permissions
Lectura1 créditosQuién tiene acceso a una cuenta GTM y con qué nivel por contenedor (read, edit, approve, publish). Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | — |
verify_gtm_conversion_tag
Lectura3 créditosAuditoría: ¿existe una etiqueta de conversión de Google Ads (awct) asociada a un activador de página de agradecimiento y hay un conversion linker? Comprueba la versión publicada por defecto. Solo lectura.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
workspaceOpcional | string | id o nombre del espacio de trabajo; por defecto: Default Workspace |
sourceOpcional | live | workspace | — |
thank_you_pathOpcional | string | fragmento de URL de la página de agradecimiento, p. ej. /tesekkurler |
Herramientas de escritura14 herramientas
connect_tag_manager
Escritura0 créditosInicia la conexión de Google Tag Manager (contenedores, espacios de trabajo, etiquetas, versiones, publicación, acceso de usuarios): devuelve un enlace de autorización de un solo uso que el usuario abre (el mismo flujo que connect_account). Nada se conecta hasta que el usuario inicie sesión.
Esta herramienta no recibe parámetros.
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_gtm_container
Escritura5 créditosCrea en una cuenta un contenedor de GTM nuevo y vacío (con sus propias etiquetas, activadores, variables e id GTM-XXXX). Elemento de aprobación; nada se ejecuta hasta instalar su fragmento y publicar una versión.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
account_idOpcional | string | id o nombre de la cuenta de GTM; opcional si solo hay una cuenta |
usage_contextOpcional | web | server | amp | android | ios | por defecto web |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_gtm_container
EscrituraIrreversible3 créditosElimina PERMANENTEMENTE un contenedor de GTM completo con todas sus etiquetas, activadores, variables y versiones. Nunca se aplica automáticamente: siempre espera la aprobación explícita del usuario. El contenedor debe indicarse explícitamente.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerObligatorio | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_gtm_entity
Escritura3 créditosEdita una etiqueta, activador, variable o espacio de trabajo de GTM existente por su ruta: renombrar, notas, parámetros (fusionados por clave o sustituidos), los activadores de una etiqueta o su indicador de pausa. La vista previa muestra valores anteriores y nuevos; se aplica tras la aprobación; nada se publica hasta publish_gtm_version.
| Parámetro | Tipo | Descripción |
|---|---|---|
kindObligatorio | tag | trigger | variable | workspace | — |
pathObligatorio | string | ruta completa de list_gtm_tags / triggers / variables / workspaces |
nameOpcional | string | — |
notesOpcional | string | — |
descriptionOpcional | string | solo espacio de trabajo |
parametersOpcional | array<object> | objetos de parámetros GTM sin procesar, p. ej. [{type: 'template', key: 'eventName', value: 'purchase'}] |
replace_parametersOpcional | boolean | true sustituye todos los parámetros; por defecto se fusionan por clave |
firing_trigger_idsOpcional | array<string> | solo etiqueta; sustituye los activadores |
pausedOpcional | boolean | solo etiqueta |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
delete_gtm_entity
EscrituraIrreversible3 créditosElimina PERMANENTEMENTE una etiqueta, activador, variable o espacio de trabajo de GTM mediante su ruta. Nunca se aplica automáticamente: siempre espera la aprobación explícita del usuario.
| Parámetro | Tipo | Descripción |
|---|---|---|
kindObligatorio | tag | trigger | variable | workspace | — |
pathObligatorio | string | ruta completa de list_gtm_tags / triggers / variables / workspaces |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_gtm_workspace
Escritura2 créditosCrea un espacio de trabajo GTM. Abre un elemento de aprobación con vista previa; se crea solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
nameObligatorio | string | — |
descriptionOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_gtm_tag
Escritura2 créditosCrea una etiqueta GTM (evento GA4, conversión de Google Ads, conversion linker, etiqueta de Google o HTML personalizado) en un espacio de trabajo. La vista previa muestra el cuerpo GTM exacto; se aplica tras la aprobación; nada se publica hasta publish_gtm_version.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
workspaceOpcional | string | id o nombre del espacio de trabajo; por defecto: Default Workspace |
nameObligatorio | string | — |
kindObligatorio | ga4_event | ads_conversion | conversion_linker | google_tag | html | custom | — |
tag_typeOpcional | string | kind=custom: GTM tag type code (e.g. gaawc, img, sp) |
parametersOpcional | array<object> | raw GTM parameter objects, e.g. [{type: 'template', key: 'eventName', value: 'purchase'}] |
firing_optionOpcional | oncePerEvent | oncePerLoad | unlimited | — |
paramsOpcional | object | ga4_event: event_name, measurement_id (G-…), event_parameters {nombre: valor o {{Variable}}}, send_ecommerce_data. ads_conversion: conversion_id (AW-… o dígitos), conversion_label, value, currency, order_id. google_tag: tag_id. html: html. |
firing_trigger_idsOpcional | array<string> | — |
firing_trigger_namesOpcional | array<string> | nombres de activadores (p. ej. 'All Pages') resueltos a ids al aplicar |
notesOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_gtm_trigger
Escritura2 créditosCrea un activador GTM (página vista, evento personalizado, clic, envío de formulario, …) con condiciones opcionales. Elemento de aprobación con vista previa.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
workspaceOpcional | string | id o nombre del espacio de trabajo; por defecto: Default Workspace |
nameObligatorio | string | — |
kindOpcional | click | custom_event | dom_ready | element_visibility | form_submission | history_change | js_error | link_click | page_view | pageview | scroll_depth | timer | window_loaded | — |
event_nameOpcional | string | para kind=custom_event |
page_pathOpcional | string | atajo: disparar solo cuando Page URL contiene esto |
conditionsOpcional | array<object> | — |
wait_for_tagsOpcional | boolean | — |
notesOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_gtm_variable
Escritura2 créditosCrea una variable GTM definida por el usuario (capa de datos, constante, cookie, URL, JavaScript, elemento DOM, tabla de búsqueda). Elemento de aprobación con vista previa.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
workspaceOpcional | string | id o nombre del espacio de trabajo; por defecto: Default Workspace |
nameObligatorio | string | — |
kindOpcional | auto_event | constant | cookie | custom_js | data_layer | dom_element | javascript | lookup_table | url | — |
paramsOpcional | object | data_layer: data_layer_name, version, default_value. constant: value. javascript/cookie: name. url: component, query_key. custom_js: javascript. dom_element: element_id o selector, attribute. lookup_table: input, table. |
variable_typeOpcional | string | kind=custom: GTM variable type code (e.g. gas, r, f) |
parametersOpcional | array<object> | raw GTM parameter objects, e.g. [{type: 'template', key: 'eventName', value: 'purchase'}] |
notesOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
enable_gtm_builtin_variables
Escritura2 créditosHabilita variables integradas de GTM (Click URL, Form ID, Page Path, …) en un espacio de trabajo. Elemento de aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
workspaceOpcional | string | id o nombre del espacio de trabajo; por defecto: Default Workspace |
variablesObligatorio | array<string> | p. ej. ['Click URL', 'Form ID', 'Page Path'] |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
publish_gtm_version
EscrituraIrreversible2 créditosCrea una versión del contenedor con nombre a partir del espacio de trabajo y la publica. Es la operación GTM más arriesgada: siempre se previsualiza con el nombre y las notas de la versión y se aplica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
workspaceOpcional | string | id o nombre del espacio de trabajo; por defecto: Default Workspace |
version_nameObligatorio | string | — |
notesOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
revert_gtm_version
EscrituraIrreversible2 créditosVuelve a publicar una versión anterior del contenedor (por defecto, la anterior a la publicada). Elemento de aprobación; usa list_gtm_versions primero.
| Parámetro | Tipo | Descripción |
|---|---|---|
containerOpcional | string | id del contenedor, id público GTM-XXXXXXX, nombre o ruta accounts/A/containers/C |
account_idOpcional | string | — |
version_idOpcional | string | omitir para volver a la versión anterior a la publicada |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_gtm_permission
Escritura2 créditosConcede o cambia el acceso de un usuario a Google Tag Manager: nivel de cuenta (user/admin) y por contenedor (read, edit, approve, publish, noAccess). Los usuarios existentes se actualizan; los correos nuevos se invitan. La vista previa muestra el acceso actual y el nuevo; se aplica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id o nombre de la cuenta GTM; opcional si solo hay una cuenta |
emailObligatorio | string | — |
account_permissionOpcional | user | admin | noAccess | — |
containersOpcional | array<object> | — |
replace_containersOpcional | boolean | true: la lista sustituye todo el acceso a contenedores; por defecto se fusiona |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
remove_gtm_permission
EscrituraIrreversible2 créditosElimina a un usuario de una cuenta de Google Tag Manager y de todos sus contenedores. La vista previa muestra el acceso que se elimina; se aplica solo tras la aprobación.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | — |
emailObligatorio | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.