如需本資源的方法清單,請見本頁結尾。
資源表示法
使用者資源代表與企業相關聯的帳戶。該帳戶可以是特定裝置的帳戶,也可以是個別使用者的帳戶 (隨後可以在多部裝置上使用相同帳戶)。視身分識別模型而定,帳戶可能只會提供 Google Play 管理版或其他 Google 服務的存取權:
- 如要使用 Google 管理的網域身分識別模型,請將相關作業同步到 Google 帳戶來源 (透過
primaryEmail
)。 - Google Play 管理版帳戶身分模型可讓企業視需要以動態方式建立使用者或裝置帳戶。這些帳戶可以存取 Google Play 管理版。
{ "kind": "androidenterprise#user", "id": string, "managementType": string, "accountType": string, "primaryEmail": string, "accountIdentifier": string, "displayName": string }
資源名稱 | 價值 | 說明 | 附註 |
---|---|---|---|
accountIdentifier |
string |
您為這位使用者建立的專屬 ID,例如「user342」或「asset#44418」。請勿在這項資源中使用個人識別資訊 (PII)。一律為受 EMM 管理的使用者設定。未針對 Google 管理的使用者設定。 | |
accountType |
string |
這位使用者代表的帳戶類型。userAccount 可以安裝在多部裝置上,但 deviceAccount 僅限單一裝置使用。EMM 管理的使用者 (emmManaged ) 可以是類型 (userAccount ,deviceAccount ),但由 Google 管理的使用者 (googleManaged ) 一律為 userAccount 。
可接受的值為:
|
|
displayName |
string |
顯示在使用者介面中的名稱。建立由 EMM 管理的使用者時,您可以選擇是否要設定這項屬性。如已設定這項屬性,請使用與機構相關的通用名稱 (例如「Example, Inc.」) 或您的姓名 (例如 EMM)。不適用於由 Google 管理的使用者帳戶。 | 可寫入 |
id |
string |
使用者的專屬 ID。 |
|
kind |
string |
||
managementType |
string |
管理使用者的實體。建立「googleManaged 」的使用者為 Google 的可靠資料來源,因此 EMM 必須確認該使用者擁有 Google 帳戶。為 emmManaged 位使用者,EMM 會負責掌管。可接受的值為:
|
|
primaryEmail |
string |
使用者的主要電子郵件地址,例如「jsmith@example.com」。一律為受管理 Google 使用者設定,且不會為受管理的 EMM 使用者設定。 |
方法
- 刪除
- 已刪除由 EMM 管理的使用者。
- generateAuthenticationToken
- 產生驗證權杖,裝置政策用戶端可用來在裝置上佈建特定 EMM 管理的使用者帳戶。產生的權杖僅限單次使用,幾分鐘後就會失效。
您最多可為每位使用者佈建 10 部裝置。
這場通話僅適用於由 EMM 代管的帳戶。 - 取得
- 擷取使用者的詳細資料。
- getAvailableProductSet
- 擷取使用者有權存取的產品組合。
- 插入
- 建立新的 EMM 管理使用者。
在要求主體中傳遞的 Users 資源應包含accountIdentifier
和accountType
。如果對應的使用者已存在相同的帳戶 ID,系統就會以資源更新使用者。在此情況下,您只能變更
displayName
欄位。 - list
- 依據主要電子郵件地址查詢使用者。 這項功能僅適用於由 Google 管理的使用者。由於由 Users.insert 呼叫的結果中已傳回這個 ID,因此由 EMM 管理的使用者不需要查詢該 ID。
- revokeDeviceAccess
- 撤銷使用者目前佈建所有裝置的存取權。使用者將無法再於任何受管理的裝置上使用 Google Play 管理版商店。
這場通話僅適用於由 EMM 代管的帳戶。 - setAvailableProductSet
- 修改使用者有權存取的產品組合 (稱為「已加入許可清單」whitelisted的產品)。只有已核准的產品或先前已核准 (已撤銷核准的產品) 才能加入許可清單。
- 更新
- 更新 EMM 管理使用者的詳細資料。
僅適用於受 EMM 管理的使用者,而非 Google 管理的使用者。 請在要求主體的 Users 資源中傳遞新的詳細資料。只能變更displayName
欄位。其他欄位則不得設定,或具備目前使用中的值。