Container Versions

Versions d'un conteneur Une version de conteneur peut être considérée comme une copie immuable (instantanée) de la configuration d'un conteneur à un moment précis. Lorsque vous créez une version à l'aide de la méthode create, vous créez une version basée sur la configuration actuelle (c'est-à-dire les macros, les règles et les balises du conteneur). La méthode restore restaure la configuration du conteneur à l'aide de la version spécifiée. La méthode update permet de mettre à jour les champs name et notes d'une version. Pour récupérer la version actuellement publiée, utilisez la méthode get et spécifiez published pour containerVersionId.

La liste des méthodes associées à cette ressource est présentée au bas de la page.

Représentations de la ressource

Représente la version d'un conteneur Google Tag Manager.

{
  "accountId": string,
  "containerId": string,
  "containerVersionId": string,
  "name": string,
  "deleted": boolean,
  "notes": string,
  "container": accounts.containers Resource,
  "macro": [
    {
      "accountId": string,
      "containerId": string,
      "macroId": string,
      "name": string,
      "type": string,
      "notes": string,
      "scheduleStartMs": long,
      "scheduleEndMs": long,
      "parameter": [
        {
          "type": string,
          "key": string,
          "value": string,
          "list": [
            (Parameter)
          ],
          "map": [
            (Parameter)
          ]
        }
      ],
      "enablingRuleId": [
        string
      ],
      "disablingRuleId": [
        string
      ],
      "fingerprint": string,
      "parentFolderId": string
    }
  ],
  "rule": [
    {
      "accountId": string,
      "containerId": string,
      "ruleId": string,
      "name": string,
      "notes": string,
      "condition": [
        {
          "type": string,
          "parameter": [
            {
              "type": string,
              "key": string,
              "value": string,
              "list": [
                (Parameter)
              ],
              "map": [
                (Parameter)
              ]
            }
          ]
        }
      ],
      "fingerprint": string
    }
  ],
  "tag": [
    accounts.containers.tags Resource
  ],
  "trigger": [
    accounts.containers.triggers Resource
  ],
  "variable": [
    accounts.containers.variables Resource
  ],
  "folder": [
    accounts.containers.folders Resource
  ],
  "fingerprint": string
}
Nom de propriété Valeur Description Remarques
accountId string ID de compte GTM.
container nested object Conteneur dont cette version a été extraite.
containerId string ID de conteneur GTM.
containerVersionId string Le containerVersionId identifie de manière unique la version du conteneur Google Tag Manager.
deleted boolean La valeur "true" indique que cette version du conteneur a été supprimée.
fingerprint string Empreinte de la version du conteneur Google Tag Manager calculée au moment du stockage. Cette valeur est recalculée à chaque modification de la version du conteneur.
folder[] list Dossiers du conteneur d'où provient cette version.
macro[] list Macros du conteneur d'où provient cette version.
macro[].accountId string ID de compte GTM.
macro[].containerId string ID de conteneur GTM.
macro[].disablingRuleId[] list Pour les conteneurs pour mobile uniquement: liste des ID des règles permettant de désactiver les macros conditionnelles. La macro est activée si l'une des règles d'activation est vraie alors que toutes les règles de désactivation sont fausses. Traitée comme un ensemble non ordonné.
macro[].enablingRuleId[] list Pour les conteneurs pour mobile uniquement: liste des ID de règles permettant d'activer des macros conditionnelles. La macro est activée si l'une des règles d'activation est vraie alors que toutes les règles de désactivation sont fausses. Traitée comme un ensemble non ordonné.
macro[].fingerprint string Empreinte numérique de la macro GTM, calculée au moment du stockage. Cette valeur est recalculée à chaque modification de la macro.
macro[].macroId string L'ID de macro identifie la macro GTM de manière unique.
macro[].name string Nom d'affichage de la macro.
macro[].notes string Notes de l'utilisateur sur la manière d'appliquer cette macro dans le conteneur
macro[].parameter[] list Paramètres de la macro.
macro[].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
macro[].parameter[].list[] list Paramètres de ce paramètre de liste (les clés seront ignorées). accessible en écriture
macro[].parameter[].map[] list Paramètres de ce paramètre de mappage (clés et clés doivent être uniques). accessible en écriture
macro[].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.


Valeurs acceptées :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
accessible en écriture
macro[].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
macro[].parentFolderId string ID du dossier parent.
macro[].scheduleEndMs long Code temporel de fin, en millisecondes, de la programmation d'une macro.
macro[].scheduleStartMs long Code temporel de début, en millisecondes, pour programmer une macro.
macro[].type string Type de macro GTM.
name string Nom à afficher pour la version du conteneur accessible en écriture
notes string Notes des utilisateurs sur la manière d'appliquer cette version de conteneur dans le conteneur accessible en écriture
rule[] list Règles du conteneur d'où provient cette version.
rule[].accountId string ID de compte GTM.
rule[].condition[] list Liste des conditions qui composent cette règle (opérateur AND implicite entre elles).
rule[].condition[].parameter[] list Une liste de paramètres nommés (clé/valeur), en fonction du type de la condition. Remarques:
  • Pour les opérateurs binaires, incluez des paramètres nommés arg0 et arg1 afin de spécifier les opérandes de gauche et de droite, respectivement.
  • Pour le moment, l'opérande de gauche (arg0) doit faire référence à une variable.
  • Pour une correspondance avec expression régulière non sensible à la casse, incluez un paramètre booléen nommé ignore_case défini sur true. Si elle n'est pas spécifiée ou définie sur une autre valeur, la correspondance est sensible à la casse.
  • Pour annuler un opérateur, incluez un paramètre booléen nommé negate défini sur true.
accessible en écriture
rule[].condition[].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
rule[].condition[].parameter[].list[] list Paramètres de ce paramètre de liste (les clés seront ignorées). accessible en écriture
rule[].condition[].parameter[].map[] list Paramètres de ce paramètre de mappage (clés et clés doivent être uniques). accessible en écriture
rule[].condition[].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.


Valeurs acceptées :
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
accessible en écriture
rule[].condition[].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
rule[].condition[].type string Type d'opérateur pour cette condition.

Valeurs acceptées :
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
accessible en écriture
rule[].containerId string ID de conteneur GTM.
rule[].fingerprint string Empreinte numérique de la règle GTM, calculée au moment du stockage. Cette valeur est recalculée à chaque modification de la règle.
rule[].name string Nom à afficher de la règle.
rule[].notes string Notes de l'utilisateur sur la manière d'appliquer cette règle dans le conteneur
rule[].ruleId string L'ID de règle identifie la règle GTM de manière unique.
tag[] list Balises du conteneur d'où provient cette version.
trigger[] list Déclencheurs du conteneur d'où provient cette version.
variable[] list Variables du conteneur d'où provient cette version.

Méthodes

créer
Crée une version du conteneur.
supprimer
Supprime une version du conteneur.
get
Récupère une version du conteneur.
liste
Répertorie toutes les versions d'un conteneur GTM.
publish
Publie une version de conteneur.
restaurer
Reste une version de conteneur. La configuration actuelle du conteneur sera écrasée (y compris ses variables, déclencheurs et balises). Cette opération n'aura aucun effet sur la version diffusée (c'est-à-dire la version publiée).
undelete
Annule la suppression d'une version de conteneur.
mise à jour
Met à jour une version du conteneur.