如需本資源的方法清單,請見本頁結尾。
資源表示法
使用者資源代表與企業相關聯的帳戶。該帳戶可以是特定裝置或個別使用者 (使用者可在多部裝置上使用該帳戶)。視身分識別模式而定,該帳戶只能提供 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 }
資源名稱 | 值 | 說明 | Notes |
---|---|---|---|
accountIdentifier |
string |
您為這個使用者建立的唯一識別碼,例如「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 使用者採用真實資訊來源,因此 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 管理的使用者。您不需要為 EMM 管理的使用者查詢 ID,因為 ID 已傳回於 Users.insert 呼叫的結果中。
- revokeDeviceAccess
- 撤銷目前提供給使用者的所有裝置存取權。使用者將無法透過任何受管理裝置使用 Google Play 管理版商店。
這場通話僅適用於由 EMM 管理的帳戶。 - setAvailableProductSet:
- 修改使用者有權存取的一組產品 (稱為「已加入許可清單」的產品)。只有已核准的產品或先前獲得核准的產品 (已撤銷核准的產品) 才能加入許可清單。注意:此項目已不適用。新的整合作業無法使用這個方法,並請參閱新建議。
- 更新
- 更新 EMM 管理使用者的詳細資料。
只能搭配 EMM 管理的使用者 (而非 Google 管理的使用者) 使用。 在要求主體的 Users 資源中傳送新詳細資料。只有displayName
欄位可以變更。您必須設定其他欄位,或是保留目前的值。