Macros

容器的宏。宏表示在运行时计算的值。您可以在配置规则和代码时引用这些宏。如需详细了解可为 Google 跟踪代码管理器宏设置的属性，请参阅宏字典参考。如需了解用户如何设置和使用宏，请参阅 Google 跟踪代码管理器帮助中心中的宏。

有关此类资源的方法列表，请参阅本页面的结尾部分。

资源表示形式

表示 Google 跟踪代码管理器宏。

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

属性名称	值	说明	备注
accountId	string	GTM 账号 ID。
containerId	string	GTM 容器 ID。
disablingRuleId[]	list	仅适用于移动容器：用于停用条件宏的规则 ID 列表；如果某个启用规则为 true，且所有停用规则为 false，则会启用相应宏。处理时，会将其视为无序集。	可写
enablingRuleId[]	list	仅适用于移动容器：用于启用条件宏的规则 ID 列表；如果某个启用规则为 true，且所有停用规则为 false，则会启用相应宏。处理时，会将其视为无序集。	可写
fingerprint	string	GTM 宏的指纹，以存储时计算的值为准。每当修改宏时，都会重新计算此值。
macroId	string	唯一标识 GTM 宏的宏 ID。
name	string	宏显示名。	可写
notes	string	有关如何在容器中应用此宏的用户注释。	可写
parameter[]	list	宏的参数。	可写
parameter[].key	string	唯一标识参数的命名键。对于顶级参数及映射值，该键属于必需项。但对于列表值，会忽略该键。	可写
parameter[].list[]	list	该列表参数的参数（键将被忽略）。	可写
parameter[].map[]	list	该映射参数的参数（必须提供键；且键必须具有唯一性）。	可写
parameter[].type	string	参数类型。有效值： boolean：该值表示布尔值，以“true”或“false”表示 integer：该值表示 64 位的正负十进制整数值 list：应指定的参数的列表 map：应指定的参数的映射 template：该值表示任何文本；可以包括宏引用，甚至是可能返回非字符串类型的宏引用 可接受的值： "boolean" "integer" "list" "map" "template"	可写
parameter[].value	string	适用于指定类型的参数的值，可以包含宏引用，例如“”。	可写
parentFolderId	string	父文件夹 ID。
scheduleEndMs	long	用于安排宏的结束时间戳（以毫秒为单位）。	可写
scheduleStartMs	long	用于安排宏的开始时间戳（以毫秒为单位）。	可写
type	string	GTM 宏类型。	可写

方法

使用以下方法创建、修改、删除或检索代码。

create

创建 GTM 宏。

删除

删除 GTM 宏。

get

获取 GTM 宏。

list

列出容器的所有 GTM 宏。

update

更新 GTM 宏。