Google Cloud Identity groups().create()的customer_id取值说明
Cloud Identity API
groups().create 接口 customer_id 字段取值说明 该字段要求传入Google Workspace租户的全局唯一数字客户ID,属于Workspace组织的专属标识,和Google Cloud控制台的资源ID、短格式快捷值均不通用,这也是你之前传入各类值都触发Invalid resource.parent报错的核心原因。
正确的customer_id获取路径
- 有效取值为纯数字字符串,长度通常为10-15位,和Google Cloud项目、OAuth客户端的ID分属两套独立的资源管理体系,不存在映射关系。
- 获取方式:
- 调用Admin SDK的
customers().get()接口,将固定快捷值my_customer作为customerKey参数传入,接口返回结果中的customerId字段,就是可直接用于Cloud Identity API的真实租户ID。注意:my_customer仅作为Admin SDK的快捷映射值存在,不能直接作为Cloud Identity API的customer_id传入,这是高频踩坑点。 - 登录Google Workspace管理控制台,进入「账户」-「设置」-「偏好设置」页面,拉到页面底部找到「客户ID」字段,直接复制对应的纯数字值即可。
- 调用Admin SDK的
已尝试取值无效的对应原因
- 传入OAuth 2.0客户端ID、客户端ID数字部分、云项目标识符:这类值属于Google Cloud资源体系,无法用于Workspace租户的资源定位,不符合接口的parent参数格式要求。
- 传入
me、管理员邮箱、字符串my_customer:这类短值仅在Admin SDK的部分接口中支持自动映射到当前授权租户,Cloud Identity API的groups.create接口不支持这类快捷值解析,必须传入真实的数字租户ID。
参数拼接注意事项
正确的parent字段格式为customers/前缀拼接获取到的纯数字租户ID,示例格式:
"parent": "customers/123456789012345"
另外可以优化代码中的附加参数写法,无需手动修改request对象的uri属性,直接将initialGroupConfig作为create方法的传入参数即可,避免出现URI拼接格式错误:
# 替代原手动拼接uri的实现 request = service.groups().create( body=group, initialGroupConfig="WITH_INITIAL_OWNER" )
内容的提问来源于stack exchange,提问作者hganger
相关产品推荐
相关产品推荐

