Variables: create

Crea una variable de GTM. Pruébalo ahora.

Solicitud

Solicitud HTTP

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

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 autenticación y autorización.

Cuerpo de la solicitud

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

Nombre de la propiedad Valor Descripción Notas
Propiedades obligatorias
formatValue.convertFalseToValue.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 "falso".
  • integer: El valor representa un número entero de 64 bits con firma, 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, lo que puede incluir referencias de variables (incluso referencias de variables que podrían mostrar tipos que no sean 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
formatValue.convertNullToValue.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 "falso".
  • integer: El valor representa un número entero de 64 bits con firma, 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, lo que puede incluir referencias de variables (incluso referencias de variables que podrían mostrar tipos que no sean 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
formatValue.convertTrueToValue.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 "falso".
  • integer: El valor representa un número entero de 64 bits con firma, 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, lo que puede incluir referencias de variables (incluso referencias de variables que podrían mostrar tipos que no sean 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
formatValue.convertUndefinedToValue.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 "falso".
  • integer: El valor representa un número entero de 64 bits con firma, 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, lo que puede incluir referencias de variables (incluso referencias de variables que podrían mostrar tipos que no sean 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 variable. 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 "falso".
  • integer: El valor representa un número entero de 64 bits con firma, 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, lo que puede incluir referencias de variables (incluso referencias de variables que podrían mostrar tipos que no sean 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 variable de GTM. admite escritura
Propiedades opcionales
disablingTriggerId[] list Solo para contenedores móviles: Una lista de IDs de activadores para inhabilitar variables condicionales. La variable está habilitada si uno de los activadores de habilitación es verdadero, mientras que todos los activadores de inhabilitación son falsos. Se trata como un conjunto no ordenado. admite escritura
enablingTriggerId[] list Solo para contenedores para dispositivos móviles: Es una lista de IDs de activadores para habilitar variables condicionales. La variable se habilita si uno de los activadores de habilitación es verdadero y todos los activadores de inhabilitación son falsos. Se trata como un conjunto no ordenado. admite escritura
formatValue.convertFalseToValue.key string Es la clave nombrada que identifica de forma inequívoca un parámetro. Obligatorio para los parámetros de nivel superior, así como para los valores del mapa. Se ignora para los valores de lista. admite escritura
formatValue.convertFalseToValue.list[] list Son los parámetros de este parámetro de lista (se ignorarán las claves). admite escritura
formatValue.convertFalseToValue.map[] list Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas) admite escritura
formatValue.convertFalseToValue.value string Es el valor de un parámetro (puede contener referencias de variables como "") según corresponda para el tipo especificado. admite escritura
formatValue.convertNullToValue.key string Es la clave nombrada que identifica de forma inequívoca un parámetro. Obligatorio para los parámetros de nivel superior, así como para los valores del mapa. Se ignora para los valores de lista. admite escritura
formatValue.convertNullToValue.list[] list Son los parámetros de este parámetro de lista (se ignorarán las claves). admite escritura
formatValue.convertNullToValue.map[] list Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas) admite escritura
formatValue.convertNullToValue.value string Es el valor de un parámetro (puede contener referencias de variables como "") según corresponda para el tipo especificado. admite escritura
formatValue.convertTrueToValue.key string Es la clave nombrada que identifica de forma inequívoca un parámetro. Obligatorio para los parámetros de nivel superior, así como para los valores del mapa. Se ignora para los valores de lista. admite escritura
formatValue.convertTrueToValue.list[] list Son los parámetros de este parámetro de lista (se ignorarán las claves). admite escritura
formatValue.convertTrueToValue.map[] list Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas) admite escritura
formatValue.convertTrueToValue.value string Es el valor de un parámetro (puede contener referencias de variables como "") según corresponda para el tipo especificado. admite escritura
formatValue.convertUndefinedToValue.key string Es la clave nombrada que identifica de forma inequívoca un parámetro. Obligatorio para los parámetros de nivel superior, así como para los valores del mapa. Se ignora para los valores de lista. admite escritura
formatValue.convertUndefinedToValue.list[] list Son los parámetros de este parámetro de lista (se ignorarán las claves). admite escritura
formatValue.convertUndefinedToValue.map[] list Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas) admite escritura
formatValue.convertUndefinedToValue.value string Es el valor de un parámetro (puede contener referencias de variables como "") según corresponda para el tipo especificado. admite escritura
notes string Notas del usuario sobre cómo aplicar esta variable en el contenedor. admite escritura
parameter[] list Los parámetros de la variable. admite escritura
parameter[].key string Es la clave nombrada que identifica de forma inequívoca un parámetro. Obligatorio para los parámetros de nivel superior, así como para los valores del 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
scheduleEndMs long Es la marca de tiempo de finalización en milisegundos para programar una variable. admite escritura
scheduleStartMs long Es la marca de tiempo de inicio en milisegundos para programar una variable. admite escritura

Respuesta

Si la respuesta es correcta, este método muestra un recurso de Variables en el cuerpo de la respuesta.

Pruébalo

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