Recurso Macro

Las macros de un contenedor. Las macros representan valores que se evalúan en el tiempo de ejecución. Puedes hacer referencia a macros cuando configuras reglas y etiquetas. Para obtener detalles sobre las propiedades de las macros de Google Tag Manager que se pueden configurar, consulta la referencia del diccionario del recurso Macro. Para obtener información sobre cómo pueden configurar y usar macros los usuarios, consulta Macros en el Centro de Ayuda de Google Tag Manager.

Al final de esta página encontrarás la lista de los métodos que se utilizan para este recurso.

Representación del recurso

Representa un recurso 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 recurso Account de GTM.
containerId string ID de recurso Container de GTM.
disablingRuleId[] list Solo en el caso de contenedores móviles: lista de IDs de reglas para inhabilitar las macros condicionales; la macro se habilita si el valor de una de las reglas de habilitación es "true" y el de todas las reglas de inhabilitación es "false". Se trata como un conjunto desordenado. Editable
enablingRuleId[] list Solo en el caso de contenedores móviles: lista de IDs de reglas para habilitar las macros condicionales; la macro se habilita si el valor de una de las reglas de habilitación es "true" y el de todas las reglas de inhabilitación es "false". Se trata como un conjunto desordenado. Editable
fingerprint string Huella digital del recurso Macro de GTM calculada en el momento del almacenamiento. Este valor se vuelve a calcular cada vez que se modifica el recurso Macro.
macroId string ID de recurso Macro que identifica de forma exclusiva el recurso Macro de GTM.
name string Nombre visible del recurso Macro. Editable
notes string Notas de usuario sobre cómo aplicar este recurso Macro en el recurso Container. Editable
parameter[] list Parámetros del recurso Macro. Editable
parameter[].key string Clave con nombre que identifica un parámetro de forma exclusiva. Es obligatoria en los parámetros de nivel superior, así como en los valores de mapa. Se ignora en los valores de lista. Editable
parameter[].list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). Editable
parameter[].map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). Editable
parameter[].type string Tipo de parámetro. Los valores válidos son los siguientes:
  • boolean: el valor representa un parámetro booleano configurado como "true" o "false".
  • integer: el valor representa un valor entero de 64 bits con signo, 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 devolver tipos que no son de cadena).


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
Editable
parameter[].value string Valor de un parámetro (puede contener referencias de macros como "{{myMacro}}") según requiera el tipo especificado. Editable
parentFolderId string ID de la carpeta principal.
scheduleEndMs long Marca de tiempo final en milésimas de segundo para programar una macro. Editable
scheduleStartMs long Marca de tiempo inicial en milésimas de segundo para programar una macro. Editable
type string Tipo de recurso Macro de GTM. Editable

Métodos

Usa los siguientes métodos para crear, modificar, eliminar o recuperar recursos Macro.

create
Crea un recurso Macro de GTM.
delete
Elimina un recurso Macro de GTM.
get
Obtiene un recurso Macro de GTM.
list
Enumera todos los recursos Macro de GTM que pertenecen a un recurso Container.
update
Actualiza un recurso Macro de GTM.