调用Google Tag Manager API创建容器返回404错误求助

问题重现 #

调用GTM API创建容器时返回404错误，执行代码：

getTagManager().accounts().containers().create(accountPath, container).execute();

返回的错误信息：

Caused by: com.google.api.client.googleapis.json.GoogleJsonResponseException: 404 Not Found
POST https://tagmanager.googleapis.com/tagmanager/v2/accounts/6059691330/containers
{
  "code": 404,
  "errors": [
    {
      "domain": "global",
      "message": "Not found or permission denied.",
      "reason": "notFound"
    }
  ],
  "message": "Not found or permission denied.",
  "status": "NOT_FOUND"
}

排查与解决方案 #

• 验证Account ID正确性
  确认请求中的账号ID 6059691330 存在且输入无误：登录GTM后台查看账号列表核对ID；同时检查accountPath格式是否为accounts/6059691330，避免多余符号或路径错误。

• 检查权限配置
  调用API的账号（服务账号/OAuth账号）必须拥有该GTM账号的容器创建权限：

  • 若使用服务账号，需在GTM后台将其添加为账号级用户，分配“编辑者”或“管理员”角色（容器未创建时，容器级权限无法生效）；
  • 若使用OAuth账号，确保当前登录用户在该GTM账号下有对应权限。

• 确认Tag Manager API已启用
  登录Google Cloud Console，找到对应项目，检查Tag Manager API是否已启用。未启用的API会导致请求被拦截，表现为404或权限类错误。

• 校验请求参数与认证

  • 确保container对象必填字段完整：比如name（容器名称）、usageContext（如WEB、ANDROID等）需正确设置；
  • 验证请求携带的access token有效，且包含正确的scope：https://www.googleapis.com/auth/tagmanager.edit.containers。

内容的提问来源于stack exchange，提问作者鸣泽高