Lưu ý quan trọng: Chúng tôi không còn chấp nhận các lượt đăng ký mới cho Play EMM API. Tìm hiểu thêm.

Trang này được dịch bởi Cloud Translation API.

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ị	Nội dung 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 "asset#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` dành riêng 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 của 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 đá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ã thông báo xác thực mà ứng dụng chính sách thiết bị có thể dùng để cấp phép cho một 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 tối đa 10 thiết bị cho mỗi người dùng.

Lệnh 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: Không dùng nữa: Các công cụ tích hợp mới không thể dùng phương thức này và có thể tham khảo các đề xuất mới của chúng tôi.
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 truyền trong 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 người dùng tương ứng có cùng giá trị nhận dạng tài khoản, thì người dùng đó sẽ được cập nhật tài nguyên. Trong trường hợp này, bạn chỉ 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ý. Người dùng được quản lý EMM không cần tra cứu mã nhận dạng 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ị nào được quản lý nữa.

Lệnh gọi này chỉ hoạt động với các tài khoản do EMM quản lý.
setAvailableProductSet: Không dùng nữa: Các công cụ tích hợp mới không thể dùng phương thức này và có thể tham khảo các đề xuất mới của chúng tôi.
Sửa đổi nhóm sản phẩm mà người dùng có quyền truy cập (còn gọi là các sản phẩm whitelisted). Chỉ những sản phẩm đã được 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) mới 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ỉ dùng được với người dùng do EMM quản lý (không dùng được với người dùng do Google quản lý). Truyền thông tin chi tiết mới trong tài nguyên Người dùng vào nội dung yêu cầu. Bạn chỉ có thể thay đổi trường displayName. Bạn không được đặt các trường khác hoặc có giá trị hiện đang hoạt động.