Tags: create

Crea una etiqueta de GTM. Pruébalo ahora.

Solicitud

Solicitud HTTP

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

Parámetros

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

Autorización

Esta solicitud requiere una autorización con el siguiente alcance:

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

Para obtener más información, consulta la página de autenticación y autorización.

Cuerpo de la solicitud

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

Nombre de la propiedad Valor Descripción Notas
Propiedades obligatorias
consentSettings.consentType.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 “false”
  • integer: El valor representa un valor entero firmado de 64 bits 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. esto puede incluir referencias variables (incluso referencias variables que pueden mostrar tipos que no son de cadena)
  • trigger_reference: El valor representa un activador, representado como el ID del activador.
  • tag_reference: El valor representa una etiqueta, representada como el nombre de la etiqueta.


Los valores aceptables son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
admite escritura
monitoringMetadata.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 “false”
  • integer: El valor representa un valor entero firmado de 64 bits 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. esto puede incluir referencias variables (incluso referencias variables que pueden mostrar tipos que no son de cadena)
  • trigger_reference: El valor representa un activador, representado como el ID del activador.
  • tag_reference: El valor representa una etiqueta, representada como el nombre de la etiqueta.


Los valores aceptables son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
admite escritura
name string Nombre visible de la etiqueta. admite escritura
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 “false”
  • integer: El valor representa un valor entero firmado de 64 bits 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. esto puede incluir referencias variables (incluso referencias variables que pueden mostrar tipos que no son de cadena)
  • trigger_reference: El valor representa un activador, representado como el ID del activador.
  • tag_reference: El valor representa una etiqueta, representada como el nombre de la etiqueta.


Los valores aceptables son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
admite escritura
priority.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 “false”
  • integer: El valor representa un valor entero firmado de 64 bits 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. esto puede incluir referencias variables (incluso referencias variables que pueden mostrar tipos que no son de cadena)
  • trigger_reference: El valor representa un activador, representado como el ID del activador.
  • tag_reference: El valor representa una etiqueta, representada como el nombre de la etiqueta.


Los valores aceptables son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
admite escritura
type string Tipo de etiqueta de GTM. admite escritura
Propiedades opcionales
blockingRuleId[] list ID de las reglas de bloqueo. Si alguna de las reglas mencionadas se evalúa como verdadera, la etiqueta no se activará. admite escritura
blockingTriggerId[] list ID de activador de bloqueo. Si alguno de los activadores enumerados se evalúa como verdadero, la etiqueta no se activará. admite escritura
consentSettings nested object Configuración de consentimiento de una etiqueta. admite escritura
consentSettings.consentType.key string La clave con nombre que identifica un parámetro de manera inequívoca. Obligatorio para los parámetros de nivel superior, así como los valores de mapa. Se ignora para los valores de lista. admite escritura
consentSettings.consentType.list[] list Son los parámetros de este parámetro de lista (se ignorarán las claves). admite escritura
consentSettings.consentType.map[] list Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). admite escritura
consentSettings.consentType.value string Es el valor de un parámetro (puede contener referencias de variables como "") según corresponda para el tipo especificado. admite escritura
firingRuleId[] list ID de reglas de activación Se activará una etiqueta cuando alguna de las reglas de la lista sea verdadera y todos sus blockingRuleIds (si los hay) son falsos. admite escritura
firingTriggerId[] list IDs de activadores Se activará una etiqueta cuando alguno de los activadores de la lista sea verdadero y todos sus blockingTriggerIds (si se especifica alguno) son falsos. admite escritura
liveOnly boolean Si la estableces como verdadera, esta etiqueta solo se activará en el entorno publicado (p.ej., no en el modo de vista previa ni de depuración). admite escritura
monitoringMetadata nested object Un mapa de pares clave-valor de metadatos de etiquetas que se incluirán en los datos de eventos para la supervisión de etiquetas. Notas:
  • Este parámetro debe ser del tipo MAP.
  • Cada parámetro del mapa es de tipo TEMPLATE. Sin embargo, no puede contener referencias de variables.
admite escritura
monitoringMetadata.key string La clave con nombre que identifica un parámetro de manera inequívoca. Obligatorio para los parámetros de nivel superior, así como los valores de mapa. Se ignora para los valores de lista. admite escritura
monitoringMetadata.list[] list Son los parámetros de este parámetro de lista (se ignorarán las claves). admite escritura
monitoringMetadata.map[] list Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). admite escritura
monitoringMetadata.value string Es el valor de un parámetro (puede contener referencias de variables como "") según corresponda para el tipo especificado. admite escritura
monitoringMetadataTagNameKey string Si no está vacío, el nombre visible de la etiqueta se incluirá en el mapa de metadatos de supervisión usando la clave especificada. admite escritura
notes string Notas del usuario sobre cómo aplicar esta etiqueta en el contenedor. admite escritura
parameter[] list Los parámetros de la etiqueta. admite escritura
parameter[].key string La clave con nombre que identifica un parámetro de manera inequívoca. Obligatorio para los parámetros de nivel superior, así como los valores de mapa. Se ignora para los valores de lista. admite escritura
parameter[].list[] list Son los parámetros de este parámetro de lista (se ignorarán las claves). admite escritura
parameter[].map[] list Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). admite escritura
parameter[].value string Es el valor de un parámetro (puede contener referencias de variables como "") según corresponda para el tipo especificado. admite escritura
paused boolean Indica si la etiqueta está detenida, lo que impide que se active. admite escritura
priority nested object Prioridad numérica de la etiqueta definida por el usuario Las etiquetas se activan de forma asíncrona en orden de prioridad. Las etiquetas con valor numérico más alto se activan primero. La prioridad de una etiqueta puede ser un valor positivo o negativo. El valor predeterminado es 0. admite escritura
priority.key string La clave con nombre que identifica un parámetro de manera inequívoca. Obligatorio para los parámetros de nivel superior, así como los valores de mapa. Se ignora para los valores de lista. admite escritura
priority.list[] list Son los parámetros de este parámetro de lista (se ignorarán las claves). admite escritura
priority.map[] list Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). admite escritura
priority.value string Es el valor de un parámetro (puede contener referencias de variables como "") según corresponda para el tipo especificado. admite escritura
scheduleEndMs long Es la marca de tiempo de finalización en milisegundos para programar una etiqueta. admite escritura
scheduleStartMs long Es la marca de tiempo de inicio en milisegundos para programar una etiqueta. admite escritura

Respuesta

Si se aplica correctamente, este método muestra un recurso de etiquetas en el cuerpo de la respuesta.

Pruébalo

Usa el Explorador de APIs que se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta.