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'elle est fournie, cette empreinte doit correspondre à l'empreinte de la variable dans l'espace de stockage.

Autorisation

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

Définition du champ d'application
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. Voici les valeurs possibles:
  • 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 des paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte. Cela peut inclure 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 une balise, représentée par le nom de la balise.


Valeurs acceptées :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 accessible en écriture
formatValue.convertNullToValue.type string Type de paramètre. Voici les valeurs possibles:
  • 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 des paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte. Cela peut inclure 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 une balise, représentée par le nom de la balise.


Valeurs acceptées :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 accessible en écriture
formatValue.convertTrueToValue.type string Type de paramètre. Voici les valeurs possibles:
  • 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 des paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte. Cela peut inclure 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 une balise, représentée par le nom de la balise.


Valeurs acceptées :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "tagReference"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
 accessible en écriture
formatValue.convertUndefinedToValue.type string Type de paramètre. Voici les valeurs possibles:
  • 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 des paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte. Cela peut inclure 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 une balise, représentée par le nom de la balise.


Valeurs acceptées :
  • "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. Voici les valeurs possibles:
  • 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 des paramètres doit être spécifié.
  • template: la valeur représente n'importe quel texte. Cela peut inclure 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 une balise, représentée par le nom de la balise.


Valeurs acceptées :
  • "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éclencheur pour la désactivation des variables conditionnelles. La variable est activée si l'un des déclencheurs d'activation est "true" et tous les déclencheurs de désactivation sont "false". Traitée comme un ensemble non ordonné. accessible en écriture
enablingTriggerId[] list Pour les conteneurs pour mobile 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 faux. Traitée comme un ensemble non ordonné. accessible en écriture
formatValue.convertFalseToValue.key string Clé nommée qui identifie un paramètre de manière unique. Obligatoire pour les paramètres de niveau supérieur 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 (clés et clés 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 ""), selon le type spécifié. accessible en écriture
formatValue.convertNullToValue.key string Clé nommée qui identifie un paramètre de manière unique. Obligatoire pour les paramètres de niveau supérieur 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 (clés et clés 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 ""), selon le type spécifié. accessible en écriture
formatValue.convertTrueToValue.key string Clé nommée qui identifie un paramètre de manière unique. Obligatoire pour les paramètres de niveau supérieur 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 (clés et clés 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 ""), selon le type spécifié. accessible en écriture
formatValue.convertUndefinedToValue.key string Clé nommée qui identifie un paramètre de manière unique. Obligatoire pour les paramètres de niveau supérieur 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 (clés et clés 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 ""), selon le type spécifié. accessible en écriture
notes string Notes des utilisateurs sur la manière d'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 un paramètre de manière unique. Obligatoire pour les paramètres de niveau supérieur 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 (clés et clés doivent être uniques). accessible en écriture
parameter[].value string Valeur d'un paramètre (peut contenir des références de variables telles que ""), selon le type spécifié. accessible en écriture
scheduleEndMs long Code temporel de fin en millisecondes pour programmer une variable. accessible en écriture
scheduleStartMs long Code temporel de début, en millisecondes, pour programmer une variable. accessible en écriture

Réponse

Lorsque cette méthode fonctionne, elle renvoie une ressource Variables dans le corps de 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.