Để 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à:
|
|
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à:
|
|
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
- 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ồmaccountIdentifier
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
- 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ườngdisplayName
. Bạn không được đặt các trường khác hoặc có giá trị hiện đang hoạt động.