Gracias por consultar la versión preliminar de la nueva documentación sobre la plataforma de etiquetas de Google. Este sitio web está en versión beta pública. (Comentarios)

Variable: update

Actualiza un recurso Variable 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 Variable de GTM. Ejemplo: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/variables/{variable_id}
Parámetros de consulta opcionales
fingerprint string Cuando se proporciona, esta huella digital debe coincidir con la del recurso Variable almacenado.

Autorización

Esta solicitud requiere una autorización con el siguiente alcance:

Permiso
https://www.googleapis.com/auth/tagmanager.edit.containers

Consulta más información en la página sobre autenticación y autorización.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona un recurso Variable con las siguientes propiedades:

Nombre de la propiedad Valor Descripción Notas
Propiedades obligatorias
formatValue.convertFalseToValue.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano que puede ser "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • 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 sean cadenas.
  • trigger_reference: el valor representa un activador que se representa como ID de activador.


Los valores posibles son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 Editable
formatValue.convertNullToValue.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano que puede ser "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • 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 sean cadenas.
  • trigger_reference: el valor representa un activador que se representa como ID de activador.


Los valores posibles son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 Editable
formatValue.convertTrueToValue.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano que puede ser "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • 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 sean cadenas.
  • trigger_reference: el valor representa un activador que se representa como ID de activador.


Los valores posibles son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 Editable
formatValue.convertUndefinedToValue.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano que puede ser "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • 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 sean cadenas.
  • trigger_reference: el valor representa un activador que se representa como ID de activador.


Los valores posibles son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 Editable
name string Nombre visible del recurso Variable. editable
parameter[].type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano que puede ser "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, en base 10.
  • 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 sean cadenas.
  • trigger_reference: el valor representa un activador que se representa como ID de activador.


Los valores posibles son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 Editable
type string Tipo del recurso Variable de GTM. editable
Propiedades opcionales
disablingTriggerId[] list Solo para contenedores móviles: lista de IDs de activadores para inhabilitar las variables condicionales; la variable se habilita si uno de los activadores de habilitación se configura como "true" y todos los activadores de inhabilitación se configuran como "false". Se trata como un conjunto desordenado. editable
enablingTriggerId[] list Solo para contenedores móviles: lista de IDs de activadores para habilitar las variables condicionales; la variable se habilita si uno de los activadores de habilitación se configura como "true" y todos los activadores de inhabilitación se configuran como "false". Se trata como un conjunto desordenado. editable
formatValue.convertFalseToValue.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
formatValue.convertFalseToValue.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
formatValue.convertFalseToValue.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
formatValue.convertFalseToValue.value string Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. editable
formatValue.convertNullToValue.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
formatValue.convertNullToValue.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
formatValue.convertNullToValue.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
formatValue.convertNullToValue.value string Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. editable
formatValue.convertTrueToValue.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
formatValue.convertTrueToValue.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
formatValue.convertTrueToValue.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
formatValue.convertTrueToValue.value string Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. editable
formatValue.convertUndefinedToValue.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
formatValue.convertUndefinedToValue.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
formatValue.convertUndefinedToValue.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
formatValue.convertUndefinedToValue.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 esta variable en el recurso Container. editable
parameter[] list Parámetros de la variable. 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
scheduleEndMs long Marca de tiempo final en milésimas de segundo para programar una variable. editable
scheduleStartMs long Marca de tiempo inicial en milésimas de segundo para programar una variable. editable

Respuesta

Si se realiza correctamente, este método devuelve un recurso Variable en el cuerpo de la respuesta.

Pruébalo

Usa la herramienta Explorador de APIs para hacer una llamada a este método con los datos disponibles en el momento y ver la respuesta.