Cette page a été traduite par l'API Cloud Translation.

Macros

Macros d'un conteneur Les macros représentent les valeurs évaluées au moment de l'exécution. Vous pouvez référencer des macros lorsque vous configurez des règles et des balises. Pour en savoir plus sur les propriétés pouvant être définies pour les macros Google Tag Manager, consultez l'article Documentation de référence sur les dictionnaires macros. Pour savoir comment les utilisateurs configurent et utilisent des macros, consultez l'article Macros dans le centre d'aide Google Tag Manager.

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 macro Google Tag Manager.

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

Nom de propriété	Valeur	Description	Remarques
`accountId`	`string`	ID de compte GTM.
`containerId`	`string`	ID de conteneur GTM.
`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é.	accessible en écriture
`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é.	accessible en écriture
`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.
`macroId`	`string`	L'ID de macro identifie la macro GTM de manière unique.
`name`	`string`	Nom d'affichage de la macro.	accessible en écriture
`notes`	`string`	Notes de l'utilisateur sur la manière d'appliquer cette macro dans le conteneur	accessible en écriture
`parameter[]`	`list`	Paramètres de la macro.	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[].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
`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
`parentFolderId`	`string`	ID du dossier parent.
`scheduleEndMs`	`long`	Code temporel de fin, en millisecondes, de la programmation d'une macro.	accessible en écriture
`scheduleStartMs`	`long`	Code temporel de début, en millisecondes, pour programmer une macro.	accessible en écriture
`type`	`string`	Type de macro GTM.	accessible en écriture

Méthodes

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

créer: Crée une macro GTM.
supprimer: Supprime une macro Google Tag Manager.
get: Récupère une macro GTM.
liste: Liste toutes les macros GTM d'un conteneur.
mise à jour: Met à jour une macro GTM.