注意:此开发者网站正在向 developers.google.com/tag-platform 迁移,2021 年 9 月 30 日起系统会将您重定向到新的网址

容器的宏。宏表示在运行时计算的值。您可以在配置规则和代码时引用这些宏。如需详细了解可为 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 适用于指定类型的参数的值,可以包含宏引用,例如“{{myMacro}}”。 可写入
parentFolderId string 父文件夹 ID。
scheduleEndMs long 用于安排宏的结束时间戳(以毫秒为单位)。 可写入
scheduleStartMs long 用于安排宏的开始时间戳(以毫秒为单位)。 可写入
type string GTM 宏类型。 可写入

方法

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

create
创建 GTM 宏。
delete
删除 GTM 宏。
get
获取 GTM 宏。
list
列出容器的所有 GTM 宏。
update
更新 GTM 宏。