Variables: create

Crée une variable GTM. Essayer maintenant

Requête

Requête HTTP

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

Paramètres

Nom du paramètre Valeur Description
Paramètres de chemin d'accès
parent string Chemin relatif de l'API GTM Workspace. Exemple : accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}

Autorisation

Cette requête nécessite une autorisation ayant le champ d'application suivant:

Portée
https://www.googleapis.com/auth/tagmanager.edit.containers

Pour en savoir plus, consultez la page Authentification et autorisation.

Corps de la requête

Dans le corps de la requête, indiquez une ressource "Variables" avec les propriétés suivantes:

Nom de propriété Valeur Description Remarques
Propriétés obligatoires
formatValue.convertFalseToValue.type string Type de paramètre. Les valeurs valides sont les suivantes:
  • boolean: la valeur représente une valeur booléenne, représentée par "true" ou "false".
  • integer: la valeur représente un entier signé de 64 bits, en base 10
  • list: une liste de paramètres doit être spécifiée
  • map: une carte des paramètres doit être spécifiée
  • template: la valeur représente n'importe quel texte. Cela peut inclure des références à des variables (même des références à des variables susceptibles de renvoyer des types autres que des chaînes).
  • trigger_reference: la valeur représente un déclencheur, représenté par l'ID du déclencheur.
  • tag_reference: la valeur représente un tag, sous la forme de son nom


Les valeurs acceptées sont les suivantes :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
accessible en écriture
formatValue.convertNullToValue.type string Type de paramètre. Les valeurs possibles sont les suivantes:
  • boolean: la valeur représente une valeur booléenne, représentée par "true" ou "false".
  • integer: la valeur représente un entier signé de 64 bits, en base 10
  • list: une liste de paramètres doit être spécifiée
  • map: une carte des paramètres doit être spécifiée
  • template: la valeur représente n'importe quel texte. Cela peut inclure des références à des variables (même des références à des variables susceptibles de renvoyer des types autres que des chaînes).
  • trigger_reference: la valeur représente un déclencheur, représenté par l'ID du déclencheur.
  • tag_reference: la valeur représente un tag, sous la forme de son nom


Les valeurs acceptées sont les suivantes :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
accessible en écriture
formatValue.convertTrueToValue.type string Type de paramètre. Les valeurs possibles sont les suivantes:
  • boolean: la valeur représente une valeur booléenne, représentée par "true" ou "false".
  • integer: la valeur représente un entier signé de 64 bits, en base 10
  • list: une liste de paramètres doit être spécifiée
  • map: une carte des paramètres doit être spécifiée
  • template: la valeur représente n'importe quel texte. Cela peut inclure des références à des variables (même des références à des variables susceptibles de renvoyer des types autres que des chaînes).
  • trigger_reference: la valeur représente un déclencheur, représenté par l'ID du déclencheur.
  • tag_reference: la valeur représente un tag, sous la forme de son nom


Les valeurs acceptées sont les suivantes :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
accessible en écriture
formatValue.convertUndefinedToValue.type string Type de paramètre. Les valeurs possibles sont les suivantes:
  • boolean: la valeur représente une valeur booléenne, représentée par "true" ou "false".
  • integer: la valeur représente un entier signé de 64 bits, en base 10
  • list: une liste de paramètres doit être spécifiée
  • map: une carte des paramètres doit être spécifiée
  • template: la valeur représente n'importe quel texte. Cela peut inclure des références à des variables (même des références à des variables susceptibles de renvoyer des types autres que des chaînes).
  • trigger_reference: la valeur représente un déclencheur, représenté par l'ID du déclencheur.
  • tag_reference: la valeur représente un tag, sous la forme de son nom


Les valeurs acceptées sont les suivantes :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
accessible en écriture
name string Nom à afficher de la variable. accessible en écriture
parameter[].type string Type de paramètre. Les valeurs possibles sont les suivantes:
  • boolean: la valeur représente une valeur booléenne, représentée par "true" ou "false".
  • integer: la valeur représente un entier signé de 64 bits, en base 10
  • list: une liste de paramètres doit être spécifiée
  • map: une carte des paramètres doit être spécifiée
  • template: la valeur représente n'importe quel texte. Cela peut inclure des références à des variables (même des références à des variables susceptibles de renvoyer des types autres que des chaînes).
  • trigger_reference: la valeur représente un déclencheur, représenté par l'ID du déclencheur.
  • tag_reference: la valeur représente un tag, sous la forme de son nom


Les valeurs acceptées sont les suivantes :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
accessible en écriture
type string Type de variable GTM accessible en écriture
Propriétés facultatives
disablingTriggerId[] list Pour les conteneurs pour mobile uniquement: liste des ID de déclencheurs pour la désactivation des variables conditionnelles. La variable est activée si l'un des déclencheurs d'activation est défini sur "true" et que tous les déclencheurs de désactivation sont "false". Traité comme un ensemble non ordonné. accessible en écriture
enablingTriggerId[] list Pour les conteneurs mobiles uniquement: liste des ID de déclencheur pour l'activation des variables conditionnelles. La variable est activée si l'un des déclencheurs d'activation est défini sur "true", tandis que tous les déclencheurs de désactivation sont définis sur "false". Traité comme un ensemble non ordonné. accessible en écriture
formatValue.convertFalseToValue.key string Clé nommée qui identifie de manière unique un paramètre. Obligatoire pour les paramètres de premier niveau, ainsi que pour les valeurs de mappage. Ignoré pour les valeurs de liste. accessible en écriture
formatValue.convertFalseToValue.list[] list Paramètres de ce paramètre de liste (les clés seront ignorées). accessible en écriture
formatValue.convertFalseToValue.map[] list Paramètres de ce paramètre de carte (doivent comporter des clés, qui doivent être uniques). accessible en écriture
formatValue.convertFalseToValue.value string Valeur d'un paramètre (peut contenir des références de variables telles que "") en fonction du type spécifié. accessible en écriture
formatValue.convertNullToValue.key string Clé nommée qui identifie de manière unique un paramètre. Obligatoire pour les paramètres de premier niveau, ainsi que pour les valeurs de mappage. Ignoré pour les valeurs de liste. accessible en écriture
formatValue.convertNullToValue.list[] list Paramètres de ce paramètre de liste (les clés seront ignorées). accessible en écriture
formatValue.convertNullToValue.map[] list Paramètres de ce paramètre de carte (doivent comporter des clés, qui doivent être uniques). accessible en écriture
formatValue.convertNullToValue.value string Valeur d'un paramètre (peut contenir des références de variables telles que "") en fonction du type spécifié. accessible en écriture
formatValue.convertTrueToValue.key string Clé nommée qui identifie de manière unique un paramètre. Obligatoire pour les paramètres de premier niveau, ainsi que pour les valeurs de mappage. Ignoré pour les valeurs de liste. accessible en écriture
formatValue.convertTrueToValue.list[] list Paramètres de ce paramètre de liste (les clés seront ignorées). accessible en écriture
formatValue.convertTrueToValue.map[] list Paramètres de ce paramètre de carte (doivent comporter des clés, qui doivent être uniques). accessible en écriture
formatValue.convertTrueToValue.value string Valeur d'un paramètre (peut contenir des références de variables telles que "") en fonction du type spécifié. accessible en écriture
formatValue.convertUndefinedToValue.key string Clé nommée qui identifie de manière unique un paramètre. Obligatoire pour les paramètres de premier niveau, ainsi que pour les valeurs de mappage. Ignoré pour les valeurs de liste. accessible en écriture
formatValue.convertUndefinedToValue.list[] list Paramètres de ce paramètre de liste (les clés seront ignorées). accessible en écriture
formatValue.convertUndefinedToValue.map[] list Paramètres de ce paramètre de carte (doivent comporter des clés, qui doivent être uniques). accessible en écriture
formatValue.convertUndefinedToValue.value string Valeur d'un paramètre (peut contenir des références de variables telles que "") en fonction du type spécifié. accessible en écriture
notes string Remarques de l'utilisateur expliquant comment appliquer cette variable dans le conteneur. accessible en écriture
parameter[] list Paramètres de la variable. accessible en écriture
parameter[].key string Clé nommée qui identifie de manière unique un paramètre. Obligatoire pour les paramètres de premier niveau, ainsi que pour les valeurs de mappage. Ignoré pour les valeurs de liste. accessible en écriture
parameter[].list[] list Paramètres de ce paramètre de liste (les clés seront ignorées). accessible en écriture
parameter[].map[] list Paramètres de ce paramètre de carte (doivent comporter des clés, qui doivent être uniques). accessible en écriture
parameter[].value string Valeur d'un paramètre (peut contenir des références de variables telles que "") en fonction du type spécifié. accessible en écriture
scheduleEndMs long Code temporel de fin, en millisecondes, de planification d'une variable. accessible en écriture
scheduleStartMs long Code temporel de début, en millisecondes, pour planifier une variable. accessible en écriture

Réponse

Si la requête aboutit, cette méthode renvoie une ressource "Variables" dans le corps de la réponse.

Essayer

Utilisez l'explorateur d'API ci-dessous pour appeler cette méthode sur des données en direct, puis observez la réponse.