Users

如需本資源的方法清單，請見本頁結尾。

資源表示法

使用者資源代表與企業相關聯的帳戶。該帳戶可以是特定裝置的帳戶，也可以是個別使用者的帳戶 (隨後可以在多部裝置上使用相同帳戶)。視身分識別模型而定，帳戶可能只會提供 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。

可接受的值為：
  • 「deviceAccount」
  • 「userAccount」
displayName string 顯示在使用者介面中的名稱。建立由 EMM 管理的使用者時，您可以選擇是否要設定這項屬性。如已設定這項屬性，請使用與機構相關的通用名稱 (例如「Example, Inc.」) 或您的姓名 (例如 EMM)。不適用於由 Google 管理的使用者帳戶。 可寫入
id string 使用者的專屬 ID。
kind string
managementType string 管理使用者的實體。建立「googleManaged」的使用者為 Google 的可靠資料來源，因此 EMM 必須確認該使用者擁有 Google 帳戶。有 emmManaged 位使用者，EMM 會負責掌管。

可接受的值為：
  • 「emmManaged」
  • 「googleManaged」
primaryEmail string 使用者的主要電子郵件地址，例如「jsmith@example.com」。一律為受管理 Google 使用者設定，且不會為受管理的 EMM 使用者設定。

方法

刪除
已刪除由 EMM 管理的使用者。
generateAuthenticationToken
產生驗證權杖，讓裝置政策用戶端用於 在裝置上佈建由 EMM 管理的使用者帳戶。 產生的權杖僅限單次使用，幾分鐘後就會失效。

每位使用者最多只能佈建 10 部裝置。

這場通話僅適用於由 EMM 管理的帳戶。
取得
擷取使用者的詳細資料。
getAvailableProductSet
擷取使用者有權存取的產品組合。
插入
建立新的 EMM 管理使用者。

Users 資源 傳遞的內文中應包含 accountIdentifier 及 accountType。

如果對應的使用者已存在相同的帳戶 ID， 使用者就會收到更新的資源本例中只有 可變更「displayName」欄位。

list
依據主要電子郵件地址查詢使用者， 這項功能僅適用於由 Google 管理的使用者。查詢 ID 並不是 所需的 EMM 管理使用者所需的 ID，因為 。
revokeDeviceAccess
撤銷使用者目前佈建所有裝置的存取權。該使用者 將無法再透過使用者的 受管理的裝置。

這場通話僅適用於由 EMM 管理的帳戶。
setAvailableProductSet
修改使用者有權存取的產品組合 (請參閱 標記為已加入許可清單的產品)。僅限符合以下條件的產品 已核准 或先前已核准的產品 (已撤銷核准的產品) 可以加入許可清單
更新
更新 EMM 所管理使用者的詳細資料。

僅適用於受 EMM 管理的使用者 (而非 Google 受管理使用者)。 在 使用者 將資源傳送至要求主體中僅限 displayName 欄位 可以變更其他欄位則不得設定或含有 目前使用的值。