Users

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

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ể chỉ dành riêng cho một thiết bị hoặc cho một người dùng cá nhân (sau đó, người dùng này có thể sử dụng tài khoản trên nhiều thiết bị). Tài khoản này 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 danh tính:

  • Mô hình danh tính miền do Google quản lý yêu cầu đồng bộ hoá với các nguồn Tài khoản Google (thông qua primaryEmail).
  • Mô hình danh tính Tài khoản Google Play được quản lý cung cấp một phương thức động để doanh nghiệp tạo tài khoản người dùng hoặc thiết bị khi cần. Những 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 Một giá trị nhận dạng riêng biệ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 tuỳ chọn này 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 riêng cho một thiết bị. Người dùng do EMM quản lý (emmManaged) có thể là một 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 thiết lập thuộc tính này, hãy sử dụng tên chung 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 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 Pháp nhân 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 tài khoản Google tồn tại cho người dùng. Với người dùng emmManaged, EMM 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, chẳng hạn như "Podcast@vidu.com". Sẽ luôn được đặt cho người dùng do Google quản lý và không được đặt cho người dùng được quản lý EMM.

Phương pháp

xóa
Đã xóa 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ể sử dụng để cấp phép cho 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 được tạo chỉ dùng một lần và hết hạn sau vài phút.

Bạn có thể cung cấp 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ý.
tải
Truy xuất thông tin 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. Lưu ý: Mặt hàng này không được dùng nữa. Các công cụ tích hợp mới không thể sử 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.
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 vào nội dung của yêu cầu phải bao gồm accountIdentifieraccountType.

Nếu người dùng tương ứng đã tồn tại với cùng một 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 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ý. Bạn không cần tra cứu mã nhận dạng này cho người dùng do EMM quản lý vì mã này đã được trả về trong kết quả của lệnh gọi user.insert.
revokeDeviceAccess
Thu hồi quyền truy cập vào tất cả các thiết bị mà người dùng hiện đang cấp phép. 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ý nào của họ nữa.

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