Container Versions

Las versiones de contenedor de un contenedor. Una versión de contenedor puede considerarse una copia inmutable (instantánea) de la configuración de un contenedor en un momento determinado. Si creas una versión nueva con el método create, se creará una versión basada en la configuración actual (es decir, las macros, las reglas y las etiquetas del contenedor). El método restore restablecerá la configuración del contenedor con la versión especificada. El método update permite actualizar los campos name y notes de una versión. A fin de recuperar la versión publicada actualmente, usa el método get y especifica published para el containerVersionId.

Para ver una lista de métodos para este recurso, consulta el final de esta página.

Representaciones de recursos

Representa una versión de contenedor de Google Tag Manager.

{
  "accountId": string,
  "containerId": string,
  "containerVersionId": string,
  "name": string,
  "deleted": boolean,
  "notes": string,
  "container": accounts.containers Resource,
  "macro": [
    {
      "accountId": string,
      "containerId": string,
      "macroId": string,
      "name": string,
      "type": string,
      "notes": string,
      "scheduleStartMs": long,
      "scheduleEndMs": long,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ],
      "enablingRuleId": [
        string
      ],
      "disablingRuleId": [
        string
      ],
      "fingerprint": string,
      "parentFolderId": string
    }
  ],
  "rule": [
    {
      "accountId": string,
      "containerId": string,
      "ruleId": string,
      "name": string,
      "notes": string,
      "condition": [
        {
          "type": string,
          "parameter": [
            {
              "type": string,
              "key": string,
              "value": string,
              "list": [
                (Parameter)
              ],
              "map": [
                (Parameter)
              ]
            }
          ]
        }
      ],
      "fingerprint": string
    }
  ],
  "tag": [
    accounts.containers.tags Resource
  ],
  "trigger": [
    accounts.containers.triggers Resource
  ],
  "variable": [
    accounts.containers.variables Resource
  ],
  "folder": [
    accounts.containers.folders Resource
  ],
  "fingerprint": string
}
Nombre de la propiedad Valor Descripción Notas
accountId string ID de la cuenta de GTM.
container nested object El contenedor del que se tomó esta versión.
containerId string ID del contenedor de GTM.
containerVersionId string El containerVersionId identifica de forma única la versión del contenedor de GTM.
deleted boolean El valor verdadero indica que se borró esta versión del contenedor.
fingerprint string La huella digital de la versión del contenedor de GTM tal como se calcula en el momento del almacenamiento. Este valor se vuelve a calcular cada vez que se modifica la versión del contenedor.
folder[] list Las carpetas del contenedor del que se tomó esta versión.
macro[] list Las macros en el contenedor del que se tomó esta versión.
macro[].accountId string ID de la cuenta de GTM.
macro[].containerId string ID del contenedor de GTM.
macro[].disablingRuleId[] list Solo para contenedores móviles: Es una lista de IDs de reglas para inhabilitar macros condicionales. La macro se habilita si una de las reglas de habilitación es verdadera y todas las reglas de inhabilitación son falsas. Se trata como un conjunto sin ordenar.
macro[].enablingRuleId[] list Solo para contenedores móviles: Es una lista de IDs de reglas para habilitar macros condicionales. La macro se habilita si una de las reglas de habilitación es verdadera, mientras que todas las reglas de inhabilitación son falsas. Se trata como un conjunto sin ordenar.
macro[].fingerprint string La huella digital de la macro de GTM tal como se calcula en el momento del almacenamiento. Este valor se vuelve a calcular cada vez que se modifica la macro.
macro[].macroId string El ID de la macro identifica de forma exclusiva la macro de GTM.
macro[].name string Nombre visible de la macro.
macro[].notes string Notas del usuario sobre cómo aplicar esta macro en el contenedor.
macro[].parameter[] list Los parámetros de la macro
macro[].parameter[].key string La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. admite escritura
macro[].parameter[].list[] list Los parámetros de este parámetro de lista (se ignorarán las claves). admite escritura
macro[].parameter[].map[] list Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). admite escritura
macro[].parameter[].type string Es el tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: El valor representa un valor booleano, representado como "verdadero" o "falso".
  • integer: El valor representa un número entero de 64 bits con firma, 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 mostrar tipos que no sean de strings).
  • trigger_reference: El valor representa un activador, representado como el ID del activador.


Los valores aceptables son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
admite escritura
macro[].parameter[].value string El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. admite escritura
macro[].parentFolderId string ID de la carpeta superior.
macro[].scheduleEndMs long Es la marca de tiempo de finalización en milisegundos para programar una macro.
macro[].scheduleStartMs long Es la marca de tiempo de inicio en milisegundos para programar una macro.
macro[].type string Tipo de macro de GTM.
name string Nombre visible de la versión del contenedor. admite escritura
notes string Notas del usuario sobre cómo aplicar esta versión del contenedor en el contenedor. admite escritura
rule[] list Las reglas del contenedor del que se tomó esta versión.
rule[].accountId string ID de la cuenta de GTM.
rule[].condition[] list Es la lista de condiciones que conforman esta regla (implícito AND entre ellas).
rule[].condition[].parameter[] list Una lista de parámetros con nombre (clave-valor), según el tipo de condición. Notas:
  • Para los operadores binarios, incluye parámetros llamados arg0 y arg1 a fin de especificar los operandos izquierdo y derecho, respectivamente.
  • En este momento, el operando izquierdo (arg0) debe ser una referencia a una variable.
  • Para la coincidencia de regex que no distingue mayúsculas de minúsculas, incluye un parámetro booleano llamado ignore_case que se haya establecido en true. Si no se especifica o se establece en cualquier otro valor, la coincidencia distingue mayúsculas de minúsculas.
  • Para anular un operador, incluye un parámetro booleano llamado negate parámetro que esté configurado en true.
admite escritura
rule[].condition[].parameter[].key string La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. admite escritura
rule[].condition[].parameter[].list[] list Los parámetros de este parámetro de lista (se ignorarán las claves). admite escritura
rule[].condition[].parameter[].map[] list Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). admite escritura
rule[].condition[].parameter[].type string Es el tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: El valor representa un valor booleano, representado como "verdadero" o "falso".
  • integer: El valor representa un número entero de 64 bits con firma, 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 mostrar tipos que no sean de strings).
  • trigger_reference: El valor representa un activador, representado como el ID del activador.


Los valores aceptables son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
admite escritura
rule[].condition[].parameter[].value string El valor de un parámetro (puede contener referencias variables, como "") según corresponda para el tipo especificado. admite escritura
rule[].condition[].type string Es el tipo de operador para esta condición.

Los valores aceptables son los siguientes:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
admite escritura
rule[].containerId string ID del contenedor de GTM.
rule[].fingerprint string La huella digital de la regla de GTM tal como se calculó en el momento del almacenamiento. Este valor se volverá a calcular cada vez que se modifique la regla.
rule[].name string Nombre visible de la regla.
rule[].notes string Notas del usuario sobre cómo aplicar esta regla en el contenedor.
rule[].ruleId string El ID de regla identifica de forma única la regla de GTM.
tag[] list Las etiquetas del contenedor del que se tomó esta versión.
trigger[] list Los activadores en el contenedor del que se tomó esta versión.
variable[] list Las variables en el contenedor del que se tomó esta versión.

Métodos

crear
Crea una versión de contenedor.
borrar
Borra una versión de contenedor.
get
Obtiene una versión de contenedor.
list
Enumera todas las versiones de un contenedor de GTM.
publish
Publica una versión de contenedor.
restablecer
Restablece una versión de contenedor. Esto reemplazará la configuración actual del contenedor (incluidas sus variables, activadores y etiquetas). La operación no tendrá ningún efecto en la versión publicada (es decir, la versión publicada).
undelete
Recupera una versión de contenedor.
actualizar
Actualiza una versión de contenedor.