调用Google Play Developer API创建用户始终返回500错误

我在用google-api-python-client实现Google Play开发者账号添加用户的自动化脚本时，遇到了以下问题：

• 服务账号拥有管理员权限，users.list和grants.create接口都能正常调用
• 调用users.create时始终返回500错误（Internal error encountered），但如果省略email字段会返回正确的400（Email required）
• 试过多种请求体格式（仅传邮箱、传所有非输出字段、传所有字段），甚至直接调用Rest API，结果都一样

原代码示例：

userId = 'developers/' + DEVELOPER_ID + '/users/' + user["email"]
createUserRequestBody = {
    'name': userId,
    'email': user["email"]
}
createUserRequest = service.users().create(parent="developers/" + DEVELOPER_ID, body=createUserRequestBody)
createUserRequest.execute()

核心问题：错误传入了Output-only字段name #

根据接口定义，User对象的name字段是仅用于返回结果的字段，创建用户时不需要在请求体中传入这个字段。你手动构造并传入name的操作，会导致API后端处理逻辑异常，触发500错误。

修正后的代码 #

去掉name字段，只保留必填的email即可：

createUserRequestBody = {
    'email': user["email"]
}
createUserRequest = service.users().create(parent=f"developers/{DEVELOPER_ID}", body=createUserRequestBody)
createUserRequest.execute()

额外排查步骤 #

如果修正后还是出现500错误，可以尝试以下操作：

• 用Google API Explorer直接测试users.create接口，排除客户端库的问题
• 检查Google Cloud控制台的Logging服务，搜索相关请求日志，获取更详细的错误细节
• 确认待添加的邮箱是有效的Google账号（个人或Google Workspace账号），Google Play开发者账号仅支持添加Google账号用户
• 确认服务账号已正确配置https://www.googleapis.com/auth/androidpublisher权限范围，且Android Publisher API已在Cloud控制台启用

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