Tags

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

Representación del recurso

Representa un recurso Tag de Google Tag Manager.

{
  "path": string,
  "accountId": string,
  "containerId": string,
  "workspaceId": string,
  "tagId": string,
  "name": string,
  "type": string,
  "firingRuleId": [
    string
  ],
  "blockingRuleId": [
    string
  ],
  "liveOnly": boolean,
  "priority": {
    "type": string,
    "key": string,
    "value": string,
    "list": [
      (Parameter)
    ],
    "map": [
      (Parameter)
    ]
  },
  "notes": string,
  "scheduleStartMs": long,
  "scheduleEndMs": long,
  "parameter": [
    {
      "type": string,
      "key": string,
      "value": string,
      "list": [
        (Parameter)
      ],
      "map": [
        (Parameter)
      ]
    }
  ],
  "fingerprint": string,
  "firingTriggerId": [
    string
  ],
  "blockingTriggerId": [
    string
  ],
  "setupTag": [
    {
      "tagName": string,
      "stopOnSetupFailure": boolean
    }
  ],
  "teardownTag": [
    {
      "tagName": string,
      "stopTeardownOnFailure": boolean
    }
  ],
  "parentFolderId": string,
  "tagFiringOption": string,
  "tagManagerUrl": string,
  "paused": boolean
}
Nombre de la propiedad Valor Descripción Notas
accountId string ID de recurso Account de GTM.
blockingRuleId[] list IDs de regla de bloqueo. Si alguna de las reglas de la lista tiene el valor "true", la etiqueta no se activará. Editable
blockingTriggerId[] list IDs de activador de bloqueo. Si alguno de los activadores de la lista tiene el valor "true", la etiqueta no se activará. Editable
containerId string ID de recurso Container de GTM.
fingerprint string Huella digital del recurso Tag de GTM calculada en el momento del almacenamiento. Este valor se vuelve a calcular cada vez que se modifica el recurso Tag.
firingRuleId[] list IDs de regla de activación. Se activará una etiqueta cuando cualquiera de las reglas de la lista tenga el valor "true" y todos los ID de regla de bloqueo (blockingRuleIds) correspondientes, si se ha especificado alguno, tengan el valor "false". Editable
firingTriggerId[] list IDs de activación de accionamiento. Se activará una etiqueta cuando cualquiera de los activadores de la lista tenga el valor "true" y todos los ID de activación de bloqueo (blockingTriggerIds) correspondientes, si se ha especificado alguno, tengan el valor "false". Editable
liveOnly boolean Si se configura en "true", esta etiqueta solo se activará en el entorno real (por ejemplo, no en el modo de vista previa o de depuración). Editable
name string Nombre visible del recurso Tag. Editable
notes string Notas de usuario sobre cómo aplicar este recurso Tag en el recurso Container. Editable
parameter[] list Parámetros de la etiqueta. 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 variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).
  • trigger_reference: el valor representa un activador mediante su ID.


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
editable
parameter[].value string Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. editable
parentFolderId string ID de la carpeta principal.
path string Ruta relativa de la API del recurso Tag de GTM.
paused boolean Indica si la etiqueta está en pausa, lo que impide que se active. Editable
priority nested object Prioridad numérica de la etiqueta, definida por el usuario. Las etiquetas se activan de forma asíncrona por orden de prioridad. Las que tienen un valor numérico más alto se activan primero. La prioridad de una etiqueta puede expresarse con un valor positivo o negativo. El valor predeterminado es 0. Editable
priority.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
priority.list[] list Parámetros de los parámetros de esta lista (las claves se ignorarán). editable
priority.map[] list Parámetros de los parámetros de este mapa (deben tener claves; las claves deben ser únicas). editable
priority.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 variables (incluso referencias de variables que podrían devolver tipos que no son de cadena).
  • trigger_reference: el valor representa un activador mediante su ID.


Estos son los valores posibles:
  • "boolean"
  • "integer"
  • "list"
  • "map"
  • "template"
  • "triggerReference"
  • "typeUnspecified"
editable
priority.value string Valor de un parámetro (puede contener referencias de variables como "{{myVariable}}") según requiera el tipo especificado. Editable
scheduleEndMs long Marca de tiempo final en milésimas de segundo para programar una etiqueta. Editable
scheduleStartMs long Marca de tiempo inicial en milésimas de segundo para programar una etiqueta. Editable
setupTag[] list Lista de etiquetas de configuración. Actualmente solo se permite una.
setupTag[].stopOnSetupFailure boolean Si es "true", activa la etiqueta principal únicamente si la etiqueta de configuración se activa correctamente. Si es "false", activa la etiqueta principal independientemente del estado de activación de la etiqueta de configuración.
setupTag[].tagName string Nombre de la etiqueta de configuración.
tagFiringOption string Opción para activar esta etiqueta.

Estos son los valores posibles:
  • "oncePerEvent"
  • "oncePerLoad"
  • "tagFiringOptionUnspecified"
  • "unlimited"
tagId string ID de recurso Tag que identifica de forma exclusiva el recurso Tag de GTM.
tagManagerUrl string Enlace con la UI de Tag Manager que se genera automáticamente.
teardownTag[] list Lista de etiquetas de eliminación. Actualmente solo se permite una.
teardownTag[].stopTeardownOnFailure boolean Si es "true", activa la etiqueta de eliminación únicamente si la etiqueta principal se activa correctamente. Si es "false", activa la etiqueta de eliminación independientemente del estado de activación de la etiqueta principal.
teardownTag[].tagName string Nombre de la etiqueta de eliminación.
type string Tipo del recurso Tag de GTM. editable
workspaceId string ID de recurso Workspace de GTM.

Métodos

create
Crea un recurso Tag de GTM.
delete
Elimina un recurso Tag de GTM.
get
Obtiene un recurso Tag de GTM.
list
Enumera todos los recursos Tag de GTM que pertenecen a un recurso Container.
revert
Deshace los cambios aplicados a un recurso Tag de GTM en un recurso Workspace de GTM.
update
Actualiza un recurso Tag de GTM.