Google Analytics上线用户组管理API：建组、加人、分配角色可以用代码批量做

管理几十个Google Analytics账号和媒体资源的权限，过去大多要在后台一个个点。Google Analytics帮助中心10月5日的更新说明里宣布，现在支持“User Groups Admin API”，可以用程序批量管理用户组。[1] Search Engine Land 10月12日也做了报道。[2]

能做什么

按官方说明，这次主要开放两类能力：[1]

  • 管理用户组：新建用户组、修改组信息，或按唯一标识删除用户组。

  • 管理组成员：把用户加入或移出某个用户组，并指定为“成员（Member）”或“所有者（Owner）”。

官方说法是，用户组可以简化大团队的权限管理，而这个API让这些配置可以通过代码维护和更新。[1]

使用门槛

调用这些接口，需要在对应组织里拥有User Admin或Org Admin权限。[1]

从开发者文档看，这些方法属于Google Marketing Platform Admin API，目前是v1alpha版本，接口路径以organizations开头，例如创建用户组是向organizations/{org_id}/userGroups发送POST请求。[3] 也就是说，它是在组织层面管理用户组，还处于alpha阶段，接口后续可能调整。

对谁有用

Search Engine Land认为，代理商、大企业和管理大量用户的分析团队最用得上：员工入职、离职、调岗时，可以把权限变更接进自动化流程，减少重复的后台操作，也更容易保持权限一致。[2]

需要注意，权限管理接口一旦写错，影响面也大。正式接入前，最好先在测试组织里验证，并控制好有管理权限的服务账号。

来源

[1] What's new in Google Analytics（Google Analytics帮助中心），2026年10月5日条目。

[2] Google Analytics launches User Groups Admin API for easier access management（Search Engine Land），2026年10月12日。

[3] Method: organizations.userGroups.create（Google Marketing Platform Admin API文档），2026年9月18日更新。

#GoogleAnalytics #GA4 #API #权限管理 #用户组 #网站分析