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

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Al final de esta página encontrarás la lista de los métodos que se usan con este recurso.

Representaciones de recurso

Representa un recurso Variable de Google Tag Manager.

{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "variableId": string,
  "name": string,
  "type": string,
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "enablingTriggerId": [
    string
  ],
  "disablingTriggerId": [
    string
  ],
  "fingerprint": string,
  "parentFolderId": string,
  "tagManagerUrl": string,
  "formatValue": {
    "caseConversionType": string,
    "convertNullToValue": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    },
    "convertUndefinedToValue": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    },
    "convertTrueToValue": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    },
    "convertFalseToValue": {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  }
}
Nombre de la propiedad Valor Descripción Notas
accountId string ID de recurso Account de GTM.
containerId string ID de recurso Container de GTM.
disablingTriggerId[] list Solo para contenedores móviles: lista de IDs de activadores para inhabilitar variables condicionales; la variable se habilita si uno de los activadores de habilitación se define como "true" y todos los activadores de inhabilitación se definen como "false". Se trata como un conjunto desordenado. Editable
enablingTriggerId[] list Solo para contenedores móviles: lista de IDs de activadores para habilitar variables condicionales; la variable se habilita si uno de los activadores de habilitación se define como "true" y todos los activadores de inhabilitación se definen como "false". Se trata como un conjunto desordenado. Editable
fingerprint string Huella digital del recurso Variable de GTM, calculada en el momento del almacenamiento. Este valor se vuelve a calcular cada vez que se modifica la variable.
formatValue nested object Opción que permite convertir un valor de variable a otro valor.
formatValue.caseConversionType string Opción que permite convertir un valor de variable del tipo cadena a minúsculas o mayúsculas.

Los valores posibles son los siguientes:
  • "lowercase"
  • "none"
  • "uppercase"
formatValue.convertFalseToValue nested object Valor de conversión cuando un valor de variable es "false".
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.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 a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).
  • 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.convertFalseToValue.value string Valor de un parámetro según requiera el tipo especificado. Puede contener referencias a variables, como "{{myVariable}}". Editable
formatValue.convertNullToValue nested object Valor de conversión cuando un valor de variable es nulo.
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.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 a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).
  • 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.value string Valor de un parámetro según requiera el tipo especificado. Puede contener referencias a variables, como "{{myVariable}}". Editable
formatValue.convertTrueToValue nested object Valor de conversión cuando un valor de variable es "true".
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.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 a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).
  • 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.value string Valor de un parámetro según requiera el tipo especificado. Puede contener referencias a variables, como "{{myVariable}}". Editable
formatValue.convertUndefinedToValue nested object Valor de conversión cuando un valor de variable no esté definido.
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.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 a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).
  • 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.value string Valor de un parámetro según requiera el tipo especificado. Puede contener referencias a variables, como "{{myVariable}}". Editable
name string Nombre visible del recurso Variable. 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[].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 a variables (incluso referencias a variables que podrían devolver tipos que no son de cadena).
  • 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
parameter[].value string Valor de un parámetro según requiera el tipo especificado. Puede contener referencias a variables, como "{{myVariable}}". Editable
parentFolderId string ID de la carpeta principal.
path string Ruta relativa de la API, correspondiente al recurso Variable de GTM.
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
tagManagerUrl string Enlace a la UI de Tag Manager, que se genera automáticamente.
type string Tipo del recurso Variable de GTM. Editable
variableId string ID de recurso Variable que identifica de forma exclusiva el recurso Variable de GTM.
workspaceId string ID de recurso Workspace de GTM.

Métodos

create
Crea un recurso Variable de GTM.
delete
Elimina un recurso Variable de GTM.
get
Obtiene un recurso Variable de GTM.
list
Enumera todos los recursos Variable de GTM que pertenecen a un mismo recurso Container.
revert
Deshace los cambios hechos en un recurso Variable de un recurso Workspace de GTM.
update
Actualiza un recurso Variable de GTM.