Rules

Règles d'un conteneur Les règles prennent la valeur "true" ou "false" pendant l'exécution. Elles permettent de contrôler le déclenchement d'une balise ou son blocage, ainsi que l'activation ou la désactivation des macros dans un conteneur pour mobile. Pour en savoir plus, consultez respectivement les règles de déclenchement et de désactivation de la configuration d'une balise et les règles d'activation et de désactivation de la configuration d'une macro.

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 règle Google Tag Manager.

{
  "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
}

Nom de propriété	Valeur	Description	Remarques
accountId	string	ID de compte GTM.
condition[]	list	Liste des conditions qui composent cette règle (opérateur AND implicite entre elles).	accessible en écriture
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 être une référence à une macro. 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 exclure un opérateur, incluez un paramètre booléen nommé negate et définissez-le sur true.	accessible en écriture
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
condition[].parameter[].list[]	list	Paramètres de ce paramètre de liste (les clés seront ignorées).	accessible en écriture
condition[].parameter[].map[]	list	Paramètres de ce paramètre de mappage (clés et clés doivent être uniques).	accessible en écriture
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 macro (même des références de macro pouvant renvoyer des types autres que des chaînes) Valeurs acceptées : "boolean" "integer" "list" "map" "template"	accessible en écriture
condition[].parameter[].value	string	Valeur d'un paramètre (peut contenir des références de macro telles que ""), selon le type spécifié.	accessible en écriture
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
containerId	string	ID de conteneur GTM.
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.
name	string	Nom à afficher de la règle.	accessible en écriture
notes	string	Notes de l'utilisateur sur la manière d'appliquer cette règle dans le conteneur	accessible en écriture
ruleId	string	L'ID de règle identifie la règle GTM de manière unique.

Méthodes

Utilisez les méthodes ci-dessous pour créer, modifier, supprimer ou récupérer des règles.

créer

Crée une règle GTM.

supprimer

Supprime une règle GTM.

get

Récupère une règle GTM.

liste

Liste toutes les règles GTM d'un conteneur.

mise à jour

Met à jour une règle GTM.