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 正規化，並使用 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 reviews.reply to reviews.
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、訂閱 ID) 正確無誤。
409 concurrentUpdate 嘗試更新正在同步更新的物件。 以指數輪詢方式重試要求。請避免同時修改相同資源。
5xx Generic error Google Play 伺服器發生一般錯誤。 請重試要求。

如果問題持續發生，請與 Google Play 帳戶管理員聯絡，或提交支援要求。建議查看 Play 狀態資訊主頁，瞭解是否有已知服務中斷情形。