调用GTM API创建标签时遇400错误：measurementId不能为空

调用GTM API创建标签时，使用如下请求体：

{
    "name": "Test",
    "type": "gaawc"
}

收到错误响应：

{"error": {
      "code": 400,
      "message": "vendorTemplate.parameter.measurementId: The value must not be empty.",
      "errors": [{
          "message": "vendorTemplate.parameter.measurementId: The value must not be empty.",
          "domain": "global",
          "reason": "badRequest"
      }],
      "status": "INVALID_ARGUMENT"
}}

问题原因 #

"gaawc"是Google Analytics 4（App + Web）类型的标签，这类标签要求measurementId为必填参数，你的请求体中缺少了该参数，导致API返回参数缺失的错误。

修复方案 #

在请求体中添加parameter数组，指定measurementId参数（替换为你的GA4测量ID），正确的请求体示例如下：

{
    "name": "Test",
    "type": "gaawc",
    "parameter": [
        {
            "key": "measurementId",
            "value": "G-XXXXXXXXXX"
        }
    ]
}

如果需要额外配置标签的其他属性（比如自定义事件名、启用调试模式），可以在parameter数组中添加对应键值对：

{
    "name": "Test",
    "type": "gaawc",
    "parameter": [
        {
            "key": "measurementId",
            "value": "G-XXXXXXXXXX"
        },
        {
            "key": "eventName",
            "value": "custom_event"
        },
        {
            "key": "enableDebugMode",
            "type": "BOOLEAN",
            "value": "true"
        }
    ]
}

内容的提问来源于stack exchange，提问作者Yourii Korchevskii