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ý (do máy chủ tạo trong quá trình tạo) ở 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ó thể đọc do máy chủ tạo.
duration

string (Duration format)

Khoảng thời gian mã đăng ký có hiệu lực, từ 1 phút đến Durations.MAX_VALUE, khoảng 10.000 năm. Nếu bạn không chỉ định, thời lượng mặc định sẽ 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ị ép thành Timestamps.MAX_VALUE.

Thời lượng tính bằng giây với tối đa 9 chữ số phân số, 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ó thể đọ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 được chỉ định, hệ thống sẽ áp dụng policyName cho người dùng thiết bị. 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 bất kỳ dấu gạch chéo nào. Phần còn lại của tên chính sách sẽ được suy luận.
additionalData

string

Dữ liệu tuỳ ý, không bắt buộc được liên kết với mã thông báo đăng ký. Ví dụ: mã này có thể chứa mã nhận dạng của một đơ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ẽ xuất hiện trong trường enrollmentTokenData của tài nguyên Device. Dữ liệu phải có độ dài từ 1024 ký tự trở xuống; nếu không, yêu cầu tạo sẽ không thành công.
qrCode

string

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

boolean

Liệu mã thông báo đăng ký có chỉ dùng được một lần hay không. 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òn được dùng nữa và giá trị sẽ bị bỏ qua.
allowPersonalUsage

enum (AllowPersonalUsage)

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

Đối với thiết bị do công ty sở hữu:

  • Khi 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 thiết lập thiết bị dưới dạng thiết bị được quản lý toàn diện.

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

  • Khi 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ị.
  • Việc tắt chế độ sử dụng cá nhân sẽ ngăn thiết bị cấp phép. Không thể tắt chế độ sử dụng cá nhân trên thiết bị thuộc sở hữu cá nhân.

Phương thức

create

 Tạo mã đă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 nhất định.