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
}

資源名稱	值	說明	Notes
`accountIdentifier`	`string`	您為這個使用者建立的唯一識別碼，例如「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` 使用者採用真實資訊來源，因此 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 管理的使用者。您不需要為 EMM 管理的使用者查詢 ID，因為 ID 已傳回於 Users.insert 呼叫的結果中。
revokeDeviceAccess: 撤銷目前提供給使用者的所有裝置存取權。使用者將無法透過任何受管理裝置使用 Google Play 管理版商店。

這場通話僅適用於由 EMM 管理的帳戶。
setAvailableProductSet：: 修改使用者有權存取的一組產品 (稱為「已加入許可清單」的產品)。只有已核准的產品或先前獲得核准的產品 (已撤銷核准的產品) 才能加入許可清單。注意：此項目已不適用。新的整合作業無法使用這個方法，並請參閱新建議。
更新: 更新 EMM 管理使用者的詳細資料。

只能搭配 EMM 管理的使用者 (而非 Google 管理的使用者) 使用。在要求主體的 Users 資源中傳送新詳細資料。只有 displayName 欄位可以變更。您必須設定其他欄位，或是保留目前的值。