Requiere autorización
Actualiza un recurso Trigger de GTM. Pruébalo ahora.
Solicitud
Solicitud HTTP
PUT https://www.googleapis.com/tagmanager/v2/path
Parámetros
Nombre de parámetro | Valor | Descripción |
---|---|---|
Parámetros de ruta | ||
path |
string |
Ruta relativa de la API del recurso Trigger de GTM. Ejemplo: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/triggers/{trigger_id} |
Parámetros de consulta opcionales | ||
fingerprint |
string |
Cuando se proporciona, esta huella digital debe coincidir con la del recurso Trigger almacenado. |
Autorización
Esta solicitud requiere autorización con el siguiente permiso. Consulta más información sobre la autenticación y la autorización.
Permiso |
---|
https://www.googleapis.com/auth/tagmanager.edit.containers |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporciona un recurso Trigger con las siguientes propiedades:
Nombre de la propiedad | Valor | Descripción | Notas |
---|---|---|---|
Propiedades obligatorias | |||
autoEventFilter[].parameter[] |
list |
Lista de parámetros con nombre (clave-valor), que dependen del tipo de condición. Notas:
|
editable |
autoEventFilter[].parameter[].type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
autoEventFilter[].type |
string |
Tipo de operador de esta condición.
Estos son los valores posibles:
|
editable |
checkValidation.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
continuousTimeMinMilliseconds.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
customEventFilter[].parameter[] |
list |
Lista de parámetros con nombre (clave-valor), que dependen del tipo de condición. Notas:
|
editable |
customEventFilter[].parameter[].type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
customEventFilter[].type |
string |
Tipo de operador de esta condición.
Estos son los valores posibles:
|
editable |
eventName.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
filter[].parameter[] |
list |
Lista de parámetros con nombre (clave-valor), que dependen del tipo de condición. Notas:
|
editable |
filter[].parameter[].type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
filter[].type |
string |
Tipo de operador de esta condición.
Estos son los valores posibles:
|
editable |
horizontalScrollPercentageList.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
interval.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
intervalSeconds.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
limit.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
maxTimerLengthSeconds.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
name |
string |
Nombre visible del recurso Trigger. | editable |
parameter[].type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
selector.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
totalTimeMinMilliseconds.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
uniqueTriggerId.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
verticalScrollPercentageList.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
visibilitySelector.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
visiblePercentageMax.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
visiblePercentageMin.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
waitForTags.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
waitForTagsTimeout.type |
string |
Tipo de parámetro. Los valores válidos son los siguientes:
Estos son los valores posibles:
|
editable |
Propiedades opcionales | |||
autoEventFilter[] |
list |
Se utiliza en el caso de seguimiento de eventos automáticos. | editable |
autoEventFilter[].parameter[].key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
autoEventFilter[].parameter[].list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
autoEventFilter[].parameter[].map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
autoEventFilter[].parameter[].value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
checkValidation |
nested object |
Indica si debemos activar las etiquetas únicamente si ningún otro gestor de eventos cancela el evento de envío de formulario o de clic en enlace (por ejemplo, debido a la validación). Solo es válido para activadores de envío de formularios y de clic en enlace. | editable |
checkValidation.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
checkValidation.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
checkValidation.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
checkValidation.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
continuousTimeMinMilliseconds |
nested object |
Tiempo visible mínimo continuo de un activador de visibilidad (en milisegundos). Solo es válido para el activador de visibilidad de AMP. | editable |
continuousTimeMinMilliseconds.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
continuousTimeMinMilliseconds.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
continuousTimeMinMilliseconds.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
continuousTimeMinMilliseconds.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
customEventFilter[] |
list |
Se utiliza en el caso de que haya eventos personalizados; se activa si se cumplen todas las condiciones. | editable |
customEventFilter[].parameter[].key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
customEventFilter[].parameter[].list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
customEventFilter[].parameter[].map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
customEventFilter[].parameter[].value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
eventName |
nested object |
Nombre del evento de GTM que se activa. Solo es válido para activadores de temporizador. | editable |
eventName.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
eventName.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
eventName.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
eventName.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
filter[] |
list |
El activador solo se activa si se cumplen todas las condiciones. | editable |
filter[].parameter[].key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
filter[].parameter[].list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
filter[].parameter[].map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
filter[].parameter[].value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
horizontalScrollPercentageList |
nested object |
Lista de valores porcentuales enteros de los activadores de desplazamiento. El activador se activa cuando se alcanza cada porcentaje al desplazar la vista en sentido horizontal. Solo es válido para los activadores de desplazamiento AMP. | editable |
horizontalScrollPercentageList.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
horizontalScrollPercentageList.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
horizontalScrollPercentageList.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
horizontalScrollPercentageList.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
interval |
nested object |
Tiempo transcurrido entre la activación de eventos de temporizador recurrentes (en milisegundos). Solo es válido para activadores de temporizador. | editable |
interval.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
interval.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
interval.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
interval.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
intervalSeconds |
nested object |
Tiempo transcurrido entre los eventos de temporizador que deben activarse (en segundos). Solo es válido para activadores de temporizador AMP. | editable |
intervalSeconds.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
intervalSeconds.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
intervalSeconds.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
intervalSeconds.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
limit |
nested object |
Límite del número de eventos de GTM que activará este activador de temporizador. Si no se configura ningún límite, seguiremos activando eventos de GTM hasta que el usuario abandone la página. Solo es válido para activadores de temporizador. | editable |
limit.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
limit.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
limit.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
limit.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
maxTimerLengthSeconds |
nested object |
Tiempo máximo para activar eventos de temporizador (en segundos). Solo es válido para activadores de temporizador AMP. | editable |
maxTimerLengthSeconds.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
maxTimerLengthSeconds.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
maxTimerLengthSeconds.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
maxTimerLengthSeconds.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
notes |
string |
Notas de usuario sobre cómo aplicar este activador en el contenedor. | editable |
parameter[] |
list |
Parámetros adicionales. | editable |
parameter[].key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
parameter[].list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
parameter[].map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
parameter[].value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
selector |
nested object |
Selector CSS de activador de clic (es decir, "a", "button", etc.). Solo es válido para el activador de clics de AMP. | editable |
selector.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
selector.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
selector.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
selector.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
totalTimeMinMilliseconds |
nested object |
Tiempo visible mínimo total de un activador de visibilidad (en milisegundos). Solo es válido para el activador de visibilidad de AMP. | editable |
totalTimeMinMilliseconds.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
totalTimeMinMilliseconds.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
totalTimeMinMilliseconds.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
totalTimeMinMilliseconds.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
type |
string |
Define el evento de capa de datos que activa este activador.
Estos son los valores posibles:
|
editable |
uniqueTriggerId |
nested object |
ID único global del activador que genera automáticamente esta acción (un envío de formulario, un clic en un enlace o un procesador del temporizador) si lo hubiera. Se utiliza para hacer que los eventos automáticos incompatibles funcionen conjuntamente con el filtrado de activación basado en los ID de activación. Este valor se rellena al generar los resultados, ya que las etiquetas que activan los activadores no existen hasta entonces. Solo es válido para activadores de envío de formularios, de clic en enlace y de temporizador. | editable |
uniqueTriggerId.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
uniqueTriggerId.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
uniqueTriggerId.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
uniqueTriggerId.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
verticalScrollPercentageList |
nested object |
Lista de valores porcentuales enteros de los activadores de desplazamiento. El activador se activa cuando se alcanza cada porcentaje al desplazar la vista en sentido vertical. Solo es válido para los activadores de desplazamiento AMP. | editable |
verticalScrollPercentageList.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
verticalScrollPercentageList.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
verticalScrollPercentageList.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
verticalScrollPercentageList.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
visibilitySelector |
nested object |
Selector CSS de un activador de visibilidad (es decir, "#id"). Solo es válido para el activador de visibilidad de AMP. | editable |
visibilitySelector.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
visibilitySelector.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
visibilitySelector.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
visibilitySelector.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
visiblePercentageMax |
nested object |
Porcentaje máximo de visibilidad de un activador de visibilidad. Solo es válido para el activador de visibilidad de AMP. | editable |
visiblePercentageMax.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
visiblePercentageMax.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
visiblePercentageMax.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
visiblePercentageMax.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
visiblePercentageMin |
nested object |
Porcentaje mínimo de visibilidad de un activador de visibilidad. Solo es válido para el activador de visibilidad de AMP. | editable |
visiblePercentageMin.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
visiblePercentageMin.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
visiblePercentageMin.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
visiblePercentageMin.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
waitForTags |
nested object |
Indica si debemos retrasar los envíos de formularios o la apertura de enlaces hasta que todas las etiquetas se hayan activado (impidiendo la acción predeterminada y simulándola más tarde). Solo es válido para activadores de envío de formularios y de clic en enlace. | editable |
waitForTags.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
waitForTags.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
waitForTags.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
waitForTags.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
waitForTagsTimeout |
nested object |
Tiempo (en milisegundos) que se debe esperar para que se activen las etiquetas cuando la propiedad 'waits_for_tags' anterior se evalúa como true . Solo es válido para activadores de envío de formularios y de clic en enlace. |
editable |
waitForTagsTimeout.key |
string |
Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. | editable |
waitForTagsTimeout.list[] |
list |
Parámetros de los parámetros de esta lista (las claves se ignorarán). | editable |
waitForTagsTimeout.map[] |
list |
Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). | editable |
waitForTagsTimeout.value |
string |
Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. | editable |
Respuesta
Si se realiza correctamente, este método devuelve un recurso Trigger en el cuerpo de la respuesta.
Pruébalo
Utiliza el siguiente explorador de APIs para probar este método con datos en tiempo real y ver la respuesta.