Variables: update

Met à jour une variable GTM. Essayer maintenant

Requête

Requête HTTP

PUT https://www.googleapis.com/tagmanager/v2/path

Paramètres

Nom du paramètre Valeur Description
Paramètres de chemin d'accès
path string Chemin relatif de l'API de la variable GTM. Exemple : accounts/{account_id}/containers/{container_id}/workspaces/{workspace_id}/variables/{variable_id}
Paramètres de requête facultatifs
fingerprint string Lorsqu'il est fourni, cet empreinte doit correspondre à l'empreinte de la variable dans l'espace de stockage.

Autorisation

Cette requête nécessite une autorisation ayant la portée suivante:

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 requises
formatValue.convertFalseToValue.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: un mappage de paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte, y compris des références de variables (même des références de variables pouvant 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 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: un mappage de paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte, y compris des références de variables (même des références de variables pouvant 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 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: un mappage de paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte, y compris des références de variables (même des références de variables pouvant 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 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: un mappage de paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte, y compris des références de variables (même des références de variables pouvant 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 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: un mappage de paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte, y compris des références de variables (même des références de variables pouvant 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 mobiles uniquement: liste des ID de déclencheur 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", tandis que tous les déclencheurs de désactivation sont définis sur "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 mappage (doivent comporter des clés, les clés doivent être uniques). accessible en écriture
formatValue.convertFalseToValue.value string Valeur d'un paramètre (peut contenir des références de variable telles que "") selon le 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 mappage (doivent comporter des clés, les clés doivent être uniques). accessible en écriture
formatValue.convertNullToValue.value string Valeur d'un paramètre (peut contenir des références de variable telles que "") selon le 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 mappage (doivent comporter des clés, les clés doivent être uniques). accessible en écriture
formatValue.convertTrueToValue.value string Valeur d'un paramètre (peut contenir des références de variable telles que "") selon le 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 mappage (doivent comporter des clés, les clés doivent être uniques). accessible en écriture
formatValue.convertUndefinedToValue.value string Valeur d'un paramètre (peut contenir des références de variable telles que "") selon le type spécifié. accessible en écriture
notes string Remarques de l'utilisateur sur l'application de 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 mappage (doivent comporter des clés, les clés doivent être uniques). accessible en écriture
parameter[].value string Valeur d'un paramètre (peut contenir des références de variable telles que "") selon le type spécifié. accessible en écriture
scheduleEndMs long Horodatage de fin, en millisecondes, pour planifier 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.