Recurso Tag: create

Requiere autorización

Crea un recurso Tag de GTM. Pruébalo ahora

Solicitud

Solicitud HTTP

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

Parámetros

Nombre de parámetro Valor Descripción
Parámetros de ruta
parent string Ruta relativa de la API del recurso Workspace de GTM. Ejemplo: accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Autorización

Esta solicitud requiere autorización con el siguiente permiso. Consulta más información sobre la autenticación y la autorización.

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

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporciona un recurso Tag con las siguientes propiedades:

Nombre de la propiedad Valor Descripción Notas
Propiedades obligatorias
name string Nombre visible del recurso Tag. Editable
parameter[].type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano configurado como "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 de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "typeUnspecified"
Editable
priority.type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano configurado como "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 de variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "typeUnspecified"
Editable
type string Tipo del recurso Tag de GTM. Editable
Propiedades opcionales
blockingRuleId[] list IDs de regla de bloqueo. Si alguna de las reglas de la lista tiene el valor "true", la etiqueta no se activará. Editable
blockingTriggerId[] list IDs de activador de bloqueo. Si alguno de los activadores de la lista tiene el valor "true", la etiqueta no se activará. Editable
firingRuleId[] list IDs de regla de activación. Se activará una etiqueta cuando cualquiera de las reglas de la lista tenga el valor "true" y todos los ID de regla de bloqueo (blockingRuleIds) correspondientes, si se ha especificado alguno, tengan el valor "false". Editable
firingTriggerId[] list IDs de activación de accionamiento. Se activará una etiqueta cuando cualquiera de los activadores de la lista tenga el valor "true" y todos los ID de activación de bloqueo (blockingTriggerIds) correspondientes, si se ha especificado alguno, tengan el valor "false". Editable
liveOnly boolean Si se configura en "true", esta etiqueta solo se activará en el entorno real (por ejemplo, no en el modo de vista previa o de depuración). Editable
notes string Notas de usuario sobre cómo aplicar este recurso Tag en el recurso Container. Editable
parameter[] list Parámetros de la etiqueta. 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[].value string Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. Editable
paused boolean Indica si la etiqueta está en pausa, lo que impide que se active. Editable
priority nested object Prioridad numérica de la etiqueta, definida por el usuario. Las etiquetas se activan de forma asíncrona por orden de prioridad. Las que tienen un valor numérico más alto se activan primero. La prioridad de una etiqueta puede expresarse con un valor positivo o negativo. El valor predeterminado es 0. Editable
priority.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
priority.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). Editable
priority.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). Editable
priority.value string Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. Editable
scheduleEndMs long Marca de tiempo final en milésimas de segundo para programar una etiqueta. Editable
scheduleStartMs long Marca de tiempo inicial en milésimas de segundo para programar una etiqueta. Editable

Respuesta

Si funciona correctamente, este método devuelve un recurso Tag en el cuerpo de la respuesta.

Pruébalo

Utiliza el Explorador de APIs para llamar a este método con datos en tiempo real y ver la respuesta.