REST Resource: users

资源：User

一种用户资源。

JSON 表示法 
{
  "name": string,
  "email": string,
  "accessState": enum (AccessState),
  "expirationTime": string,
  "partial": boolean,
  "developerAccountPermissions": [
    enum (DeveloperLevelPermission)
  ],
  "grants": [
    {
      object (Grant)
    }
  ]
}
字段
name

string

必需。相应用户的资源名称，其格式为“developers/{developer}/users/{email}”。
email

string

不可变。用户的电子邮件地址。
accessState

enum (AccessState)

仅限输出。用户对 Play 管理中心的访问权限状态。
expirationTime

string (Timestamp format)

用户的访问权限到期时间（如已设置）。如果设置此值，必须始终将其设置为未来的时间。

采用 RFC 3339 标准，生成的输出将始终进行 Z 规范化（即转换为 UTC 零时区格式并在末尾附加 Z），并使用 0、3、6 或 9 个小数位。不带“Z”的偏差时间也是可以接受的。示例："2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z" 或 "2014-10-02T15:01:23+05:30"。
partial

boolean

仅限输出。表示用户是否具有未在此处列出的更多权限。如果调用方没有权限管理账号下的所有应用，就可能会发生这种情况。如果相应用户是账号所有者，此字段也为 true。

如果此字段为 true，应将其视为一个信号，表明无法通过 API 全面管理相应用户。也就是说，API 调用方无法管理相应用户拥有的所有权限，要么是因为它不知道这些权限的存在，要么是因为该用户是账号所有者。
developerAccountPermissions[]

enum (DeveloperLevelPermission)

适用于整个开发者账号的用户权限。
grants[]

object (Grant)

仅限输出。针对每个应用的用户权限。

AccessState

用户对开发者账号的访问权限状态。

枚举
ACCESS_STATE_UNSPECIFIED 访问权限状态未知或未指定。
INVITED 用户已收到邀请，但尚未接受邀请。
INVITATION_EXPIRED 邀请已过期。
ACCESS_GRANTED 用户已接受邀请，并且可以访问 Play 管理中心。
ACCESS_EXPIRED 账号访问权限已过期。

DeveloperLevelPermission

在开发者账号级别授予的权限。

枚举
DEVELOPER_LEVEL_PERMISSION_UNSPECIFIED 权限未知或未指定。
CAN_SEE_ALL_APPS

查看应用信息和批量下载报告（只读）。已弃用：请查看 CAN_VIEW_NON_FINANCIAL_DATA_GLOBAL。
CAN_VIEW_FINANCIAL_DATA_GLOBAL 查看财务数据、订单和用户取消订阅时对调查问卷的书面回复。
CAN_MANAGE_PERMISSIONS_GLOBAL 管理员（所有权限）。
CAN_EDIT_GAMES_GLOBAL 修改 Play Games 服务项目。
CAN_PUBLISH_GAMES_GLOBAL 发布 Play Games 服务项目。
CAN_REPLY_TO_REVIEWS_GLOBAL 对评价的回复。
CAN_MANAGE_PUBLIC_APKS_GLOBAL 发布为正式版，排除设备以及使用 Google Play 应用签名功能。
CAN_MANAGE_TRACK_APKS_GLOBAL 发布到测试轨道。
CAN_MANAGE_TRACK_USERS_GLOBAL 管理测试轨道和修改测试人员列表。
CAN_MANAGE_PUBLIC_LISTING_GLOBAL 管理商店发布。
CAN_MANAGE_DRAFT_APPS_GLOBAL 创建、修改和删除草稿应用。
CAN_CREATE_MANAGED_PLAY_APPS_GLOBAL 为所在组织创建和发布专用应用。
CAN_CHANGE_MANAGED_PLAY_SETTING_GLOBAL 选择是让应用公开发布，还是仅面向所在组织发布。
CAN_MANAGE_ORDERS_GLOBAL 管理订单和订阅。
CAN_MANAGE_APP_CONTENT_GLOBAL 管理相应开发者的所有应用上的政策相关页面。
CAN_VIEW_NON_FINANCIAL_DATA_GLOBAL 查看应用信息和批量下载报告（只读）。
CAN_VIEW_APP_QUALITY_GLOBAL 查看相应开发者的所有应用的质量信息。

方法

create

 向用户授予对指定开发者账号的访问权限。

delete

 移除用户对指定开发者账号的全部访问权限。

list

 列出所有对某个开发者账号拥有访问权限的用户。

patch

 更新用户对开发者账号的访问权限。

错误代码

此资源的操作会返回以下 HTTP 错误代码：

错误代码 原因 说明 分辨率
400 invalidValue 请求中提供的值无效。如果购买令牌格式有误或无效，系统通常会返回此错误。 根据 API 参考文档，更正请求正文或参数中的无效字段值。
400 required 请求中缺少必需的字段或参数。 请参阅 API 文档，确保包含所有必填字段和参数。
403 userInsufficientPermission 用户没有足够的权限来执行所请求的操作。 确保经过身份验证的用户在 Google Play 管理中心内拥有必要的权限。如需了解详情，请参阅 使用服务账号。
404 notFound 找不到所请求的资源。 验证标识符（例如购买令牌、软件包名称、商品 ID、订阅 ID）是否正确。
409 concurrentUpdate 尝试更新正在并发更新的对象。 使用指数退避算法重试请求。避免同时修改同一资源。
5xx Generic error Google Play 服务器中的一般错误。 请重试您的请求。

如果问题仍然存在，请与您的 Google Play 客户经理联系，或提交支持请求。不妨查看 Play 状态信息中心，了解是否存在任何已知的服务中断。