Triggers: update

Requiere autorización

Actualiza un recurso Trigger de GTM. Pruébalo ahora o consulta un ejemplo.

Solicitud

Solicitud HTTP

PUT https://www.googleapis.com/tagmanager/v1/accounts/accountId/containers/containerId/triggers/triggerId

Parámetros

Nombre de parámetro Valor Descripción
Parámetros de ruta
accountId string ID de recurso Account de GTM.
containerId string ID de recurso Container de GTM.
triggerId string ID de recurso Trigger de GTM.
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 ámbito. Consulta más información sobre la autenticación y la autorización.

Alcance
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:
  • En el caso de los operadores binarios, incluye los parámetros arg0 y arg1 para especificar los operandos izquierdo y derecho, respectivamente.
  • Por ahora, el operando izquierdo (arg0) debe ser una referencia a una variable.
  • Para las coincidencias de expresión regular que no distingan entre mayúsculas y minúsculas, incluye un parámetro booleano ignore_case configurado en true. Si no se especifica o si se configura en cualquier otro valor, la coincidencia distinguirá entre mayúsculas y minúsculas.
  • Para negar un operador, incluye un parámetro booleano negate configurado en true.
editable
autoEventFilter[].parameter[].type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
autoEventFilter[].type string Tipo de operador de esta condición.

Estos son los valores posibles:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
editable
checkValidation.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
continuousTimeMinMilliseconds.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
customEventFilter[].parameter[] list Lista de parámetros con nombre (clave-valor), que dependen del tipo de condición. Notas:
  • En el caso de los operadores binarios, incluye los parámetros arg0 y arg1 para especificar los operandos izquierdo y derecho, respectivamente.
  • Por ahora, el operando izquierdo (arg0) debe ser una referencia a una variable.
  • Para las coincidencias de expresión regular que no distingan entre mayúsculas y minúsculas, incluye un parámetro booleano ignore_case configurado en true. Si no se especifica o si se configura en cualquier otro valor, la coincidencia distinguirá entre mayúsculas y minúsculas.
  • Para negar un operador, incluye un parámetro booleano negate configurado en true.
editable
customEventFilter[].parameter[].type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
customEventFilter[].type string Tipo de operador de esta condición.

Estos son los valores posibles:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
editable
eventName.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
filter[].parameter[] list Lista de parámetros con nombre (clave-valor), que dependen del tipo de condición. Notas:
  • En el caso de los operadores binarios, incluye los parámetros arg0 y arg1 para especificar los operandos izquierdo y derecho, respectivamente.
  • Por ahora, el operando izquierdo (arg0) debe ser una referencia a una variable.
  • Para las coincidencias de expresión regular que no distingan entre mayúsculas y minúsculas, incluye un parámetro booleano ignore_case configurado en true. Si no se especifica o si se configura en cualquier otro valor, la coincidencia distinguirá entre mayúsculas y minúsculas.
  • Para negar un operador, incluye un parámetro booleano negate configurado en true.
editable
filter[].parameter[].type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
filter[].type string Tipo de operador de esta condición.

Estos son los valores posibles:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
editable
horizontalScrollPercentageList.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
interval.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
intervalSeconds.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
limit.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
maxTimerLengthSeconds.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
name string Nombre visible del recurso Trigger. editable
parameter[].type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
selector.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
totalTimeMinMilliseconds.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
uniqueTriggerId.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
verticalScrollPercentageList.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
visibilitySelector.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
visiblePercentageMax.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
visiblePercentageMin.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
waitForTags.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
editable
waitForTagsTimeout.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano como "true" o "false".
  • integer: el valor representa un valor entero decimal de 64 bits con signo.
  • list: se debe especificar una lista de parámetros.
  • map: se debe especificar un mapa de parámetros.
  • template: el valor representa cualquier texto; puede incluir referencias de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
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, que 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, que 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, que 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, que 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, que 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, que 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, que 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, que 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, que 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 establece 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, que 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, que 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
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, que 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, que 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, que 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:
  • "always"
  • "ampClick"
  • "ampScroll"
  • "ampTimer"
  • "ampVisibility"
  • "click"
  • "customEvent"
  • "domReady"
  • "elementVisibility"
  • "formSubmission"
  • "historyChange"
  • "jsError"
  • "linkClick"
  • "pageview"
  • "scrollDepth"
  • "timer"
  • "windowLoaded"
  • "youTubeVideo"
editable
uniqueTriggerId nested object ID único global del activador que genera automáticamente esta propiedad (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, que 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, que 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, que 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, que 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, que 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, que 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, que 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 Triggers en el cuerpo de la respuesta.

Ejemplos

Nota: Los ejemplos de código disponibles para este método no representan todos los lenguajes de programación admitidos (consulta la página de bibliotecas de cliente para obtener una lista de los lenguajes admitidos).

Java

Utiliza la biblioteca de cliente Java.

/*
 * Note: This code assumes you have an authorized tagmanager service object.
 */

/*
 * This request updates an existing trigger for the authorized user.
 */

// Create the condition parameters objects.
Parameter arg0 = new Parameter();
arg0.setType("template");
arg0.setKey("arg0");
arg0.setValue("{{Page URL}}");
Parameter arg1 = new Parameter();
arg1.setType("template");
arg1.setKey("arg1");
arg1.setValue("timed.html");

// Create the auto event condition object.
Condition condition = new Condition();
condition.setType("contains");
condition.setParameter(Arrays.asList(arg0, arg1));

// Create the event parameter.
Parameter eventName = new Parameter();
eventName.setType("template");
eventName.setValue("gtm.timer");

// Create the interval parameter.
Parameter interval = new Parameter();
interval.setType("template");
interval.setValue("10000");

// Create the limit parameter.
Parameter limit = new Parameter();
limit.setType("template");
limit.setValue("10");

// Create the trigger object.
Trigger trigger = new Trigger();
trigger.setName("Updated Timer Trigger");
trigger.setType("timer");
trigger.setAutoEventFilter(Arrays.asList(condition));
trigger.setEventName(eventName);
trigger.setInterval(interval);
trigger.setLimit(limit);

try {
  Trigger response = tagmanager.accounts().containers().
      triggers().update("123456", "54321", "1", trigger).execute();
} catch (GoogleJsonResponseException e) {
  System.err.println("There was a service error: "
      + e.getDetails().getCode() + " : "
      + e.getDetails().getMessage());
}

/*
 * The results of the update method are stored in the response object.
 * The following code shows how to access the updated name and fingerprint.
 */
System.out.println("Updated Name = " + response.getName());
System.out.println("Updated Fingerprint = " + response.getFingerprint());

Python

Utiliza la biblioteca de cliente Python.

# Note: This code assumes you have an authorized tagmanager service object.

# This request updates an existing trigger.
try:
  response = tagmanager.accounts().containers().triggers().update(
      accountId='123456',
      containerId='54321',
      triggerId='3',
      body={
          'name': 'Updated Timed trigger',
          'type': 'timer',
          'autoEventFilter': [
              {
                  'type': 'contains',
                  'parameter': [
                      {
                          'type': 'template',
                          'key': 'arg0',
                          'value': '{{Page URL}}'
                      },
                      {
                          'type': 'template',
                          'key': 'arg1',
                          'value': 'timed.html'
                      }
                  ]
              }
          ],
          'eventName': {
              'type': 'template',
              'value': 'gtm.timer'
          },
          'interval': {
              'type': 'template',
              'value': '10000'
          },
          'limit': {
              'type': 'template',
              'value': '10'
          }
      }
  ).execute()

except TypeError, error:
  # Handle errors in constructing a query.
  print 'There was an error in constructing your query : %s' % error

except HttpError, error:
  # Handle API errors.
  print ('There was an API error : %s : %s' %
         (error.resp.status, error.resp.reason))

# The results of the update method are stored in the response object.
# The following code shows how to access the updated name and fingerprint.
print 'Updated Name = %s' % response.get('name')
print 'Updated Fingerprint = %s' % response.get('fingerprint')

Pruébalo

Utiliza el siguiente explorador de APIs para llamar a este método con datos en tiempo real y ver la respuesta.