Rules

Las reglas de un contenedor. Las reglas se evalúan como verdadero o falso durante el tiempo de ejecución. Se pueden utilizar para controlar cuándo se activa o no una etiqueta, y para controlar cuándo se habilitan o inhabilitan las macros de un contenedor para dispositivos móviles. Para obtener más detalles, consulta las reglas de inhabilitación y activación de la configuración de una etiqueta, y las reglas de habilitación o inhabilitación de la configuración de macro, respectivamente.

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

Representaciones de recursos

Representa una regla de 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
}

Nombre de la propiedad	Valor	Descripción	Notas
accountId	string	ID de la cuenta de GTM.
condition[]	list	Es la lista de condiciones que conforman esta regla (implícito AND entre ellas).	admite escritura
condition[].parameter[]	list	Una lista de parámetros con nombre (clave-valor), según el tipo de condición. Notas: Para los operadores binarios, incluye parámetros llamados arg0 y arg1 a fin de especificar los operandos izquierdo y derecho, respectivamente. En este momento, el operando izquierdo (arg0) debe ser una referencia a una macro. Para la coincidencia de regex que no distingue mayúsculas de minúsculas, incluye un parámetro booleano llamado ignore_case que se haya establecido en true. Si no se especifica o se establece en cualquier otro valor, la coincidencia distingue mayúsculas de minúsculas. Para negar un operador, incluye un parámetro booleano llamado negate y establécelo en true.	admite escritura
condition[].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
condition[].parameter[].list[]	list	Los parámetros de este parámetro de lista (se ignorarán las claves).	admite escritura
condition[].parameter[].map[]	list	Los parámetros de este parámetro de mapa (deben tener claves; las claves deben ser únicas).	admite escritura
condition[].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
condition[].parameter[].value	string	El valor de un parámetro (puede contener referencias de macro como "") según corresponda para el tipo especificado.	admite escritura
condition[].type	string	Es el tipo de operador para esta condición. Los valores aceptables son los siguientes: "contains" "cssSelector" "endsWith" "equals" "greater" "greaterOrEquals" "less" "lessOrEquals" "matchRegex" "startsWith" "urlMatches"	admite escritura
containerId	string	ID del contenedor de GTM.
fingerprint	string	La huella digital de la regla de GTM tal como se calculó en el momento del almacenamiento. Este valor se volverá a calcular cada vez que se modifique la regla.
name	string	Nombre visible de la regla.	admite escritura
notes	string	Notas del usuario sobre cómo aplicar esta regla en el contenedor.	admite escritura
ruleId	string	El ID de regla identifica de forma única la regla de GTM.

Métodos

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

crear

Crea una regla de GTM.

borrar

Borra una regla de GTM.

get

Obtiene una regla de GTM.

list

Enumera todas las reglas de GTM de un contenedor.

actualizar

Actualiza una regla de GTM.