REST Resource: enterprises.enrollmentTokens

Tài nguyên: EnrollmentToken

Mã thông báo đăng ký.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "value": string,
  "duration": string,
  "expirationTimestamp": string,
  "policyName": string,
  "additionalData": string,
  "qrCode": string,
  "oneTimeOnly": boolean,
  "user": {
    object (User)
  },
  "allowPersonalUsage": enum (AllowPersonalUsage)
}
Trường
name

string

Tên của mã thông báo đăng ký, được máy chủ tạo trong quá trình tạo, có dạng enterprises/{enterpriseId}/enrollmentTokens/{enrollmentTokenId}.
value

string

Giá trị mã thông báo được truyền đến thiết bị và cho phép thiết bị đăng ký. Đây là trường chỉ đọc do máy chủ tạo.
duration

string (Duration format)

Khoảng thời gian mã thông báo đăng ký có hiệu lực, trong khoảng từ 1 phút đến Durations.MAX_VALUE, khoảng 10.000 năm. Nếu không được chỉ định, thời lượng mặc định là 1 giờ. Xin lưu ý rằng nếu thời lượng được yêu cầu khiến expirationTimestamp thu được vượt quá Timestamps.MAX_VALUE, thì expirationTimestamp sẽ bị buộc thành Timestamps.MAX_VALUE.

Thời lượng tính bằng giây với tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".
expirationTimestamp

string (Timestamp format)

Thời gian hết hạn của mã thông báo. Đây là trường chỉ đọc do máy chủ tạo.

Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z" và "2014-10-02T15:01:23.045123456Z".
policyName

string

Tên của chính sách ban đầu được áp dụng cho thiết bị đã đăng ký, ở dạng enterprises/{enterpriseId}/policies/{policyId}. Nếu không chỉ định, policyName cho người dùng thiết bị sẽ được áp dụng. Nếu bạn cũng không chỉ định userName, thì enterprises/{enterpriseId}/policies/default sẽ được áp dụng theo mặc định. Khi cập nhật trường này, bạn chỉ có thể chỉ định policyId miễn là policyId không chứa dấu gạch chéo. Phần còn lại của tên chính sách sẽ được suy ra.
additionalData

string

Dữ liệu không bắt buộc, tuỳ ý được liên kết với mã thông báo đăng ký. Chẳng hạn như thông tin này có thể chứa mã của đơn vị tổ chức mà thiết bị được chỉ định sau khi đăng ký. Sau khi thiết bị đăng ký bằng mã thông báo, dữ liệu này sẽ hiển thị trong trường enrollmentTokenData của tài nguyên Device. Dữ liệu chỉ được có tối đa 1.024 ký tự. Nếu không, yêu cầu tạo sẽ không thành công.
qrCode

string

Chuỗi JSON có mã đại diện UTF-8 được dùng để tạo mã QR nhằm đăng ký thiết bị bằng mã thông báo đăng ký này. Để đăng ký một thiết bị bằng NFC, bản ghi NFC phải chứa nội dung trình bày java.util.Properties tuần tự của các thuộc tính trong tệp JSON.
oneTimeOnly

boolean

Liệu mã thông báo đăng ký chỉ dùng một lần. Nếu bạn đặt cờ này thành true thì chỉ một thiết bị có thể sử dụng cờ này để đăng ký.
user
(deprecated)

object (User)

Trường này không được dùng nữa và giá trị này sẽ bị bỏ qua.
allowPersonalUsage

enum (AllowPersonalUsage)

Kiểm soát việc người dùng có được phép sử dụng cho mục đích cá nhân trên thiết bị được cấp phép bằng mã thông báo đăng ký này hay không.

Đối với thiết bị thuộc quyền sở hữu của công ty:

  • Khi bạn bật chế độ sử dụng cá nhân, người dùng có thể thiết lập hồ sơ công việc trên thiết bị.
  • Để tắt chế độ sử dụng cá nhân, người dùng phải cấp phép cho thiết bị dưới dạng thiết bị được quản lý hoàn toàn.

Đối với thiết bị thuộc sở hữu của cá nhân:

  • Khi bạn bật chế độ sử dụng cá nhân, người dùng có thể thiết lập hồ sơ công việc trên thiết bị.
  • Khi bạn tắt chế độ sử dụng cá nhân, thiết bị sẽ không được cấp phép. Không thể tắt chế độ sử dụng cho mục đích cá nhân trên thiết bị thuộc sở hữu của cá nhân.

Phương thức

create

 Tạo mã thông báo đăng ký cho một doanh nghiệp cụ thể.

delete

 Xoá mã thông báo đăng ký.

get

 Nhận mã thông báo đăng ký đang hoạt động và chưa hết hạn.

list

 Liệt kê các mã thông báo đăng ký đang hoạt động và chưa hết hạn cho một doanh nghiệp cụ thể.