Macros

Las macros de un contenedor Las macros representan valores que se evalúan durante el tiempo de ejecución. Puedes hacer referencia a macros cuando configuras reglas y etiquetas. Si deseas obtener más información sobre las propiedades que se pueden configurar para las macros de Google Tag Manager, consulta la Referencia de Macro Dictionary. Para obtener información sobre cómo los usuarios configuran y utilizan las macros, consulte el artículo Macros en el Centro de ayuda de Google Tag Manager.

Para ver una lista de métodos para este recurso, consulta el final de esta página.

Representaciones de recursos

Representa una macro de 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
}
Nombre de la propiedad Valor Descripción Notas
accountId string ID de la cuenta de GTM.
containerId string ID del contenedor de GTM.
disablingRuleId[] list Solo para contenedores móviles: Es una lista de IDs de reglas para inhabilitar macros condicionales. La macro se habilita si una de las reglas de habilitación es verdadera y todas las reglas de inhabilitación son falsas. Se trata como un conjunto sin ordenar. admite escritura
enablingRuleId[] list Solo para contenedores móviles: Es una lista de IDs de reglas para habilitar macros condicionales. La macro se habilita si una de las reglas de habilitación es verdadera, mientras que todas las reglas de inhabilitación son falsas. Se trata como un conjunto sin ordenar. admite escritura
fingerprint string La huella digital de la macro de GTM tal como se calcula en el momento del almacenamiento. Este valor se vuelve a calcular cada vez que se modifica la macro.
macroId string El ID de la macro identifica de forma exclusiva la macro de GTM.
name string Nombre visible de la macro. admite escritura
notes string Notas del usuario sobre cómo aplicar esta macro en el contenedor. admite escritura
parameter[] list Los parámetros de la macro admite escritura
parameter[].key string La clave con nombre que identifica un parámetro de forma única. Obligatorio para los parámetros de nivel superior, así como para los valores de mapa. Se ignora para los valores de lista. admite escritura
parameter[].list[] list Los parámetros de este parámetro de lista (se ignorarán las claves). admite escritura
parameter[].map[] list Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas). admite escritura
parameter[].type string Es el tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: El valor representa un valor booleano, representado como "verdadero" o "falso".
  • integer: El valor representa un número entero de 64 bits con firma, en base 10.
  • list: Se debe especificar una lista de parámetros.
  • map: Se debe especificar un mapa de parámetros.
  • template: El valor representa cualquier texto. Puede incluir referencias de macros (incluso referencias de macros que podrían mostrar tipos que no sean de strings).


Los valores aceptables son los siguientes:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
admite escritura
parameter[].value string El valor de un parámetro (puede contener referencias de macro como "") según corresponda para el tipo especificado. admite escritura
parentFolderId string ID de la carpeta superior.
scheduleEndMs long Es la marca de tiempo de finalización en milisegundos para programar una macro. admite escritura
scheduleStartMs long Es la marca de tiempo de inicio en milisegundos para programar una macro. admite escritura
type string Tipo de macro de GTM. admite escritura

Métodos

Usa los siguientes métodos para crear, modificar, borrar o recuperar macros.

crear
Crea una macro de GTM.
borrar
Borra una macro de GTM.
get
Obtiene una macro de GTM.
list
Enumera todas las macros de GTM de un contenedor.
actualizar
Actualiza una macro de GTM.