Agradecemos seu interesse na nova documentação da plataforma de tags do Google. Este site está na versão Beta pública. (Feedback)

Tags: create

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Cria um tag do GTM. Faça um teste.

Solicitação

Solicitação HTTP

POST https://www.googleapis.com/tagmanager/v2/+parent/tags

Parâmetros

Nome do parâmetro Valor Descrição
Parâmetros de caminho
parent string Caminho relacionado à API do Workspace do GTM. Por exemplo: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

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 Tags com as seguintes propriedades:

Nome da propriedade Valor Descrição Observações
Propriedades obrigatórias
consentSettings.consentType.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


Os valores aceitáveis são os seguintes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
gravável
monitoringMetadata.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


Os valores aceitáveis são os seguintes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
gravável
name string Nome de exibição da tag. 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


Os valores aceitáveis são os seguintes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
gravável
priority.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


Os valores aceitáveis são os seguintes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
gravável
type string Tipo de Tag do GTM. gravável
Propriedades opcionais
blockingRuleId[] list Códigos de regra de bloqueio. Se uma das regras listadas forem avaliadas como "true", a tag não será disparada. gravável
blockingTriggerId[] list Códigos dos acionadores de bloqueio. Se um dos acionadores listados forem avaliadas como "true", a tag não será disparada. gravável
consentSettings nested object Configurações de consentimento de uma tag. gravável
consentSettings.consentType.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
consentSettings.consentType.list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
consentSettings.consentType.map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
consentSettings.consentType.value string Valor de um parâmetro (pode conter referências de variáveis, como ""), conforme apropriado para o tipo especificado. gravável
firingRuleId[] list IDs de regra de disparo. Uma tag é disparada quando uma das regras listadas têm o valor "true" e todos os blockingRuleIds (se especificados) têm o valor "false". gravável
firingTriggerId[] list IDs de acionador de disparo. Uma tag é disparada quando um dos acionadores listados têm o valor "true" e todos os blockingTriggerIds (se especificados) têm o valor "false". gravável
liveOnly boolean Se definida como "true", essa tag só será disparada no ambiente ativo (não no modo de visualização ou depuração). gravável
monitoringMetadata nested object Um mapa de pares de chave-valor de metadados da tag a serem incluídos nos dados do evento para monitoramento de tags. Observações:
  • Esse parâmetro precisa ser do tipo MAP.
  • Cada parâmetro no mapa é do tipo TEMPLATE, mas não pode conter referências de variáveis.
gravável
monitoringMetadata.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
monitoringMetadata.list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
monitoringMetadata.map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
monitoringMetadata.value string Valor de um parâmetro (pode conter referências de variáveis, como ""), conforme apropriado para o tipo especificado. gravável
monitoringMetadataTagNameKey string Se não estiver vazio, o nome de exibição da tag será incluído no mapa de metadados de monitoramento usando a chave especificada. gravável
notes string Observações para os usuários sobre como aplicar essa tag no contêiner. gravável
parameter[] list Parâmetros da tag. 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
paused boolean Indica se a tag está pausada, que a impede de ser disparada. gravável
priority nested object Prioridade numérica da tag definida pelo usuário. As tags são disparadas de forma assíncrona na ordem de prioridade. Tags com valor numérico maior são disparadas primeiro. A prioridade de uma tag pode ser um valor positivo ou negativo. O valor padrão é 0. gravável
priority.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
priority.list[] list Parâmetros dessa lista (as chaves são ignoradas). gravável
priority.map[] list Parâmetros desse mapa (é necessário ter chaves únicas). gravável
priority.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 tag. gravável
scheduleStartMs long Data e hora de início em milissegundos para agendar uma tag. gravável

Resposta

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

Confira!

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