Container Versions

Container Versions de um contêiner. Uma versão de contêiner pode ser considerada uma cópia imutável (instantâneo) da configuração de um contêiner em um determinado ponto no tempo. Criar uma nova versão usando o método create gera uma versão com base na configuração atual, ou seja, nas macros, nas regras e nas tags do contêiner. O método restore vai restaurar a configuração do contêiner usando a versão especificada. O método update permite atualizar os campos name e notes de uma versão. Para buscar a versão publicada atualmente, use o método get e especifique published para o containerVersionId.

Para ver uma lista de métodos desse recurso, consulte o final desta página.

Representações de recursos

Representa um Container Version do Gerenciador de tags do Google.

{
  "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
}
Nome da propriedade Valor Descrição Observações
accountId string Código do Account do GTM.
container nested object Contêiner de origem dessa versão.
containerId string ID do contêiner do GTM.
containerVersionId string containerVersionId identifica de forma exclusiva o Container Version do GTM.
deleted boolean Valor "true" indica que essa versão do contêiner foi excluída.
fingerprint string Impressão digital do Container Version do GTM, conforme processada no momento do armazenamento. Esse valor é reprocessado sempre que a versão do contêiner é modificada.
folder[] list Pastas no contêiner de origem dessa versão.
macro[] list Macros no contêiner de origem dessa versão.
macro[].accountId string Código do Account do GTM.
macro[].containerId string Código do Container do GTM.
macro[].disablingRuleId[] list Apenas para contêineres de dispositivos móveis: uma lista de códigos de regras para macros condicionais de desativação. A macro será ativada se uma das regras de ativação tiver o valor "true" e todas as regras de desativação apresentarem o valor "false". Tratado como um conjunto não ordenado.
macro[].enablingRuleId[] list Apenas para contêineres para dispositivos móveis: uma lista de códigos de regras para macros condicionais de ativação. A macro será ativada se uma das regras de ativação tiver o valor "true" e todas as regras de desativação tiverem o valor "false". Tratado como um conjunto não ordenado.
macro[].fingerprint string Impressão digital do Macro do GTM, conforme processado no momento do armazenamento. Esse valor é reprocessado sempre que a macro é modificada.
macro[].macroId string Código do Macro que identifica o Macro do GTM de forma única.
macro[].name string Nome de exibição da macro.
macro[].notes string Observações para o usuário sobre como aplicar essa macro no contêiner.
macro[].parameter[] list Parâmetros da macro.
macro[].parameter[].key string Chave nomeada que identifica um parâmetro de forma única. Obrigatório para parâmetros de nível superior, bem como para valores de mapa. Ignorado para valores de lista. gravável
macro[].parameter[].list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
macro[].parameter[].map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
macro[].parameter[].type string Tipo de parâmetro. Os valores válidos são:
  • boolean: o valor representa um booleano, exibido como "true" ou "false"
  • integer: o valor representa um número inteiro assinado com 64 bits e de formato decimal
  • list: uma lista de parâmetros precisa ser especificada
  • map: um mapa de parâmetros precisa ser especificado
  • template: o valor representa qualquer texto e inclui referências de variáveis, mesmo aquelas que podem retornar tipos que não são strings
  • trigger_reference: o valor representa um acionador, que é informado como o ID do acionador


Estes são os valores aceitáveis:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
gravável
macro[].parameter[].value string Valor de um parâmetro (pode conter referências de variáveis, como ""), conforme apropriado para o tipo especificado. gravável
macro[].parentFolderId string Código da pasta pai.
macro[].scheduleEndMs long Data e hora de término em milissegundos para agendar uma macro.
macro[].scheduleStartMs long Data e hora de início em milissegundos para agendar uma macro.
macro[].type string Tipo de Macro do GTM.
name string Nome de exibição da versão do contêiner. gravável
notes string Observações para os usuários sobre como aplicar essa versão de contêiner no contêiner. gravável
rule[] list Regras no contêiner de origem dessa versão.
rule[].accountId string Código do Account do GTM.
rule[].condition[] list Lista de condições que compõem essa regra (operador "AND" implícito entre elas).
rule[].condition[].parameter[] list Lista de parâmetros nomeados (chave/valor), dependendo do tipo de condição. Observações:
  • No caso dos operadores binários, inclua os parâmetros arg0 e arg1 para especificar os operandos esquerdo e direito, respectivamente.
  • No momento, o operando esquerdo (arg0) precisa ser uma referência a uma variável.
  • Para correspondência de regex que não diferencia maiúsculas de minúsculas, inclua um parâmetro booleano ignore_case definido como true. Se não for especificada nem definida como outro valor, a correspondência diferenciará maiúsculas de minúsculas.
  • Para negar um operador, inclua um parâmetro booleano negate definido como true.
gravável
rule[].condition[].parameter[].key string Chave nomeada que identifica um parâmetro de forma única. Obrigatório para parâmetros de nível superior, bem como para valores de mapa. Ignorado para valores de lista. gravável
rule[].condition[].parameter[].list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
rule[].condition[].parameter[].map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
rule[].condition[].parameter[].type string Tipo de parâmetro. Os valores válidos são:
  • boolean: o valor representa um booleano, exibido como "true" ou "false"
  • integer: o valor representa um número inteiro assinado com 64 bits e de formato decimal
  • list: uma lista de parâmetros precisa ser especificada
  • map: um mapa de parâmetros precisa ser especificado
  • template: o valor representa qualquer texto e inclui referências de variáveis, mesmo aquelas que podem retornar tipos que não são strings
  • trigger_reference: o valor representa um acionador, que é informado como o ID do acionador


Estes são os valores aceitáveis:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
gravável
rule[].condition[].parameter[].value string Valor de um parâmetro (pode conter referências de variáveis, como ""), conforme apropriado para o tipo especificado. gravável
rule[].condition[].type string Tipo de operador para essa condição.

Os valores aceitáveis são:
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
gravável
rule[].containerId string Código do Container do GTM.
rule[].fingerprint string Impressão digital do Rule do GTM, conforme processada no armazenamento. Esse valor é reprocessado sempre que a regra é modificada.
rule[].name string Nome de exibição da regra.
rule[].notes string Observações para o usuário sobre como aplicar essa regra no contêiner.
rule[].ruleId string Código do Rule que identifica a regra do GTM de forma única.
tag[] list Tags no contêiner de origem dessa versão.
trigger[] list Acionadores no contêiner de origem dessa versão.
variable[] list Variáveis no contêiner de origem dessa versão.

Métodos

create
Cria uma versão do contêiner.
excluir
Exclui uma versão do contêiner.
get
Recebe uma versão do contêiner.
list
Lista todas as versões de um contêiner do GTM.
publish
Publica uma versão do contêiner.
restaurar
Restaura uma versão do contêiner. Substitui a configuração atual do contêiner (incluindo variáveis, acionadores e tags). A operação não tem efeito na versão veiculada (ou seja, a versão publicada).
undelete
Cancela a exclusão de uma versão do contêiner.
update
Atualiza uma versão do contêiner.