Variables: update

Atualiza uma variável do GTM. Faça um teste.

Solicitação

Solicitação HTTP

PUT https://www.googleapis.com/tagmanager/v2/path

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
path string Caminho relacionado à API do Variable do GTM. Por exemplo: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/variables/{variable_id}
Parâmetros de consulta opcionais
fingerprint string Quando fornecida, essa impressão digital precisa corresponder àquela da variável armazenada.

Autorização

Esta solicitação requer autorização com o seguinte escopo:

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

Para mais informações, consulte a página de autenticação e autorização.

Corpo da solicitação

No corpo da solicitação, informe um recurso Variables com as seguintes propriedades:

Nome da propriedade Valor Descrição Observações
Propriedades obrigatórias
formatValue.convertFalseToValue.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
  • tag_reference: o valor indica uma tag, representada como o nome da tag


Estes são os valores aceitáveis:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 gravável
formatValue.convertNullToValue.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
  • tag_reference: o valor indica uma tag, representada como o nome da tag


Estes são os valores aceitáveis:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 gravável
formatValue.convertTrueToValue.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
  • tag_reference: o valor indica uma tag, representada como o nome da tag


Estes são os valores aceitáveis:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 gravável
formatValue.convertUndefinedToValue.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
  • tag_reference: o valor indica uma tag, representada como o nome da tag


Estes são os valores aceitáveis:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 gravável
name string Nome de exibição da variável. gravável
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
  • tag_reference: o valor indica uma tag, representada como o nome da tag


Estes são os valores aceitáveis:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 gravável
type string Tipo de Variable do GTM. gravável
Propriedades opcionais
disablingTriggerId[] list Apenas para contêineres de dispositivos móveis: uma lista de códigos de acionadores para variáveis condicionais de desativação. A variável será ativada se um dos acionadores de ativação tiver o valor "true" e todos os acionadores de desativação apresentarem o valor "false". Tratado como um conjunto não ordenado. gravável
enablingTriggerId[] list Apenas para contêineres para dispositivos móveis: uma lista de códigos de acionadores para variáveis condicionais de ativação. A variável será ativada se um dos acionadores de ativação tiver o valor "true" e todos os acionadores de desativação apresentarem o valor "false". Tratado como um conjunto não ordenado. gravável
formatValue.convertFalseToValue.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
formatValue.convertFalseToValue.list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
formatValue.convertFalseToValue.map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
formatValue.convertFalseToValue.value string Valor de um parâmetro (pode conter referências de variáveis, como ""), conforme apropriado para o tipo especificado. gravável
formatValue.convertNullToValue.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
formatValue.convertNullToValue.list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
formatValue.convertNullToValue.map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
formatValue.convertNullToValue.value string Valor de um parâmetro (pode conter referências de variáveis, como ""), conforme apropriado para o tipo especificado. gravável
formatValue.convertTrueToValue.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
formatValue.convertTrueToValue.list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
formatValue.convertTrueToValue.map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
formatValue.convertTrueToValue.value string Valor de um parâmetro (pode conter referências de variáveis, como ""), conforme apropriado para o tipo especificado. gravável
formatValue.convertUndefinedToValue.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
formatValue.convertUndefinedToValue.list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
formatValue.convertUndefinedToValue.map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
formatValue.convertUndefinedToValue.value string Valor de um parâmetro (pode conter referências de variáveis, como ""), conforme apropriado para o tipo especificado. gravável
notes string Observações para os usuários sobre como aplicar essa variável no contêiner. gravável
parameter[] list Parâmetros da variável. gravável
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
parameter[].list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
parameter[].map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
parameter[].value string Valor de um parâmetro (pode conter referências de variáveis, como ""), conforme apropriado para o tipo especificado. gravável
scheduleEndMs long Data e hora de término em milissegundos para agendar uma variável. gravável
scheduleStartMs long Data e hora de início em milissegundos para agendar uma variável. gravável

Resposta

Se for bem-sucedido, este método retornará um recurso Variables no corpo da resposta.

Confira!

Use o APIs Explorer abaixo para chamar esse método em dados ativos e ver a resposta.