Users

Để biết danh sách các phương thức cho tài nguyên này, hãy xem ở cuối trang.

Biểu diễn tài nguyên

Tài nguyên Người dùng đại diện cho một tài khoản liên kết với một doanh nghiệp. Tài khoản có thể dành riêng cho một thiết bị hoặc cho một người dùng cá nhân (người sau đó có thể sử dụng tài khoản trên nhiều thiết bị). Tài khoản đó có thể chỉ cung cấp quyền truy cập vào Managed Google Play hoặc các dịch vụ khác của Google, tuỳ thuộc vào mô hình nhận dạng:

  • Mô hình nhận dạng miền do Google quản lý yêu cầu đồng bộ hoá với các nguồn của Tài khoản Google (thông qua primaryEmail).
  • Mô hình nhận dạng Tài khoản Google Play được quản lý cung cấp một phương tiện linh động để doanh nghiệp tạo tài khoản người dùng hoặc tài khoản thiết bị khi cần. Các tài khoản này cung cấp quyền truy cập vào Managed Google Play.

{
  "kind": "androidenterprise#user",
  "id": string,
  "managementType": string,
  "accountType": string,
  "primaryEmail": string,
  "accountIdentifier": string,
  "displayName": string
}
Tên tài sản Giá trị Mô tả Ghi chú
accountIdentifier string Giá trị nhận dạng duy nhất mà bạn tạo cho người dùng này, chẳng hạn như "user342" hoặc "thành phần số 44418". Đừng sử dụng thông tin nhận dạng cá nhân (PII) cho tài sản này. Phải luôn đặt cho người dùng do EMM quản lý. Không được đặt cho người dùng do Google quản lý.
accountType string Loại tài khoản mà người dùng này đại diện. Bạn có thể cài đặt userAccount trên nhiều thiết bị, nhưng deviceAccount chỉ dành cho một thiết bị riêng lẻ. Người dùng do Google quản lý (emmManaged) có thể thuộc một trong hai loại (userAccount, deviceAccount) nhưng người dùng do Google quản lý (googleManaged) luôn là userAccount.

Các giá trị được chấp nhận là:
  • "deviceAccount"
  • "userAccount"
displayName string Tên sẽ xuất hiện trong giao diện người dùng. Bạn không bắt buộc phải đặt thuộc tính này khi tạo người dùng do EMM quản lý. Nếu bạn đặt thuộc tính này, hãy sử dụng tên chung về tổ chức (chẳng hạn như "Example, Inc.") hoặc tên của bạn (như EMM). Không được sử dụng cho các tài khoản người dùng do Google quản lý. có thể ghi
id string Mã nhận dạng duy nhất cho người dùng.

kind string
managementType string Thực thể quản lý người dùng. Với người dùng googleManaged, nguồn thông tin đáng tin cậy là Google, vì vậy, EMM phải đảm bảo người dùng có Tài khoản Google. Với emmManaged người dùng, EMM sẽ là người chịu trách nhiệm.

Các giá trị được chấp nhận là:
  • "emmManaged"
  • "googleManaged"
primaryEmail string Địa chỉ email chính của người dùng, ví dụ: "jsmith@example.com". Sẽ luôn được đặt cho người dùng do Google quản lý chứ không phải cho người dùng được quản lý EMM.

Phương thức

xóa
Đã xoá một người dùng do EMM quản lý.
generateAuthenticationToken
Tạo mã xác thực mà ứng dụng chính sách thiết bị có thể dùng để cấp phép tài khoản người dùng do EMM quản lý trên một thiết bị. Mã thông báo đã tạo chỉ dùng được một lần và sẽ hết hạn sau vài phút.

Bạn có thể cấp phép cho tối đa 10 thiết bị cho mỗi người dùng.

Cuộc gọi này chỉ hoạt động với các tài khoản do EMM quản lý.
nhận
Truy xuất thông tin chi tiết của người dùng.
getAvailableProductSet
Truy xuất tập hợp sản phẩm mà người dùng có quyền truy cập.
chèn
Tạo người dùng mới do EMM quản lý.

Tài nguyên Người dùng được chuyển vào phần nội dung của yêu cầu phải bao gồm accountIdentifier và accountType.

Nếu đã tồn tại một người dùng tương ứng có cùng mã nhận dạng tài khoản, người dùng sẽ được cập nhật tài nguyên. Trong trường hợp này, chỉ Bạn có thể thay đổi trường displayName.

list
Tìm kiếm người dùng theo địa chỉ email chính. Tính năng này chỉ được hỗ trợ cho người dùng do Google quản lý. Không thể tra cứu mã nhận dạng cần thiết cho người dùng được quản lý EMM vì mã nhận dạng đã được trả về trong kết quả của lệnh gọi Users.insert.
revokeDeviceAccess
Thu hồi quyền truy cập của tất cả các thiết bị hiện được cấp phép cho người dùng. Người dùng sẽ không thể sử dụng Cửa hàng Play được quản lý trên bất kỳ thiết bị được quản lý.

Cuộc gọi này chỉ hoạt động với các tài khoản do EMM quản lý.
setAvailableProductSet
Sửa đổi tập hợp sản phẩm mà người dùng có quyền truy cập (được gọi là dưới dạng sản phẩm có trong danh sách cho phép). Chỉ những sản phẩm đã phê duyệt hoặc các sản phẩm đã được phê duyệt trước đây (sản phẩm bị thu hồi quyết định phê duyệt) có thể được đưa vào danh sách cho phép.
cập nhật
Cập nhật thông tin chi tiết của người dùng do EMM quản lý.

Chỉ có thể sử dụng với người dùng được quản lý bởi EMM (không phải người dùng do Google quản lý). Truyền chi tiết mới vào Người dùng trong nội dung yêu cầu. Chỉ trường displayName chỉnh sửa được. Bạn phải bỏ đặt các trường khác hoặc đặt giá trị giá trị hiện đang hoạt động.