Container Versions

Versions de conteneur d'un conteneur. Une version de conteneur peut être considérée comme une copie immuable (instantané) de la configuration d'un conteneur à un moment donné. Lorsque vous créez une version à l'aide de la méthode create, une version est créée en fonction de la configuration actuelle (c'est-à-dire les macros, règles et 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 une version de 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 d'où provient cette version.
containerId string ID du conteneur GTM.
containerVersionId string Le champ containerVersionId identifie de manière unique la version du conteneur GTM.
deleted boolean La valeur "true" indique que cette version du conteneur a été supprimée.
fingerprint string Empreinte numérique de la version du conteneur GTM telle qu'elle est calculée au moment du stockage. Cette valeur est recalculée à chaque modification de la version du conteneur.
folder[] list Dossiers du conteneur dont est issue cette version.
macro[] list Macros du conteneur dont est issue cette version.
macro[].accountId string ID de compte GTM.
macro[].containerId string ID du conteneur GTM.
macro[].disablingRuleId[] list Pour les conteneurs pour mobile uniquement: une liste d'identifiants de règles pour la désactivation des macros conditionnelles. La macro est activée si l'une des règles d'activation est vraie et que toutes les règles de désactivation sont fausses. Traité comme un ensemble non ordonné.
macro[].enablingRuleId[] list Pour les conteneurs pour mobile uniquement: une liste d'identifiants de règles pour l'activation de macros conditionnelles La macro est activée si l'une des règles d'activation est vraie et que toutes les règles de désactivation sont fausses. Traité comme un ensemble non ordonné.
macro[].fingerprint string Empreinte de la macro GTM calculée au moment du stockage. Cette valeur est recalculée chaque fois que la macro est modifiée.
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 expliquant comment 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 et les valeurs de carte. 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 (ils doivent comporter des clés, les clés doivent être uniques). accessible en écriture
macro[].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" (vrai). ou "false"
  • integer: la valeur représente un nombre 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. cela peut inclure des références à des variables (même des références à des variables qui pourraient 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.


Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder">
    </ph>
  • "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 variable 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 planification d'une macro.
macro[].scheduleStartMs long Code temporel de début, en millisecondes, de programmation d'une macro.
macro[].type string Type de macro GTM.
name string Nom à afficher pour la version du conteneur. accessible en écriture
notes string Remarques de l'utilisateur expliquant comment appliquer cette version au conteneur. accessible en écriture
rule[] list Règles du conteneur dont est issue 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 Liste de paramètres nommés (clé/valeur), en fonction du type de condition. Remarques:
  • Pour les opérateurs binaires, incluez des paramètres nommés arg0 et arg1 pour spécifier les opérandes gauche et droit, respectivement.
  • Pour le moment, l'opérande de gauche (arg0) doit être une référence à une variable.
  • Pour les correspondances Regex non sensibles à la casse, incluez un paramètre booléen nommé ignore_case défini sur true. Si aucune valeur n'est spécifiée ou si elle est définie sur une autre valeur, la correspondance est sensible à la casse.
  • Pour exclure 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 et les valeurs de carte. 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 (ils doivent comporter des clés, les clés doivent être uniques). accessible en écriture
rule[].condition[].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" (vrai). ou "false"
  • integer: la valeur représente un nombre 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. cela peut inclure des références à des variables (même des références à des variables qui pourraient 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.


Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder">
    </ph>
  • "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 variable telles que "") selon le type spécifié. accessible en écriture
rule[].condition[].type string Type d'opérateur pour cette condition.

Les valeurs possibles sont les suivantes: <ph type="x-smartling-placeholder">
    </ph>
  • "contains"
  • "cssSelector"
  • "endsWith"
  • "equals"
  • "greater"
  • "greaterOrEquals"
  • "less"
  • "lessOrEquals"
  • "matchRegex"
  • "startsWith"
  • "urlMatches"
accessible en écriture
rule[].containerId string ID du 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 fois que la règle est modifiée.
rule[].name string Nom à afficher de la règle.
rule[].notes string Remarques de l'utilisateur expliquant comment 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 dont est issue cette version.
trigger[] list Déclencheurs du conteneur dont est issue cette version.
variable[] list Variables du conteneur dont est issue 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.
publier
Publie une version du conteneur.
restaurer
Restaurez une version du conteneur. Cette action écrasera la version actuelle du conteneur (y compris ses variables, ses déclencheurs et ses balises). L'opération n'aura aucun effet sur la version en cours de diffusion (par exemple, version publiée).
annuler la suppression
Annule la suppression d'une version du conteneur.
mise à jour
Met à jour la version d'un conteneur.