REST Resource: enterprises.enrollmentTokens

Tài nguyên: RegistrationToken

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 do máy chủ tạo.

duration

string (Duration format)

Mã thông báo đăng ký có hiệu lực trong khoảng thời gian 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ị 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ố 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 do máy chủ tạo.

Dấu thời gian theo múi giờ "Zulu" RFC3339 (giờ UTC) với độ phân giải nano giây và lên đến 9 chữ số phân số. Ví dụ: "2014-10-02T15:01:23Z""2014-10-02T15:01:23.045123456Z".

policyName

string

Tên của chính sách được áp dụng ban đầu 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 ra.

additionalData

string

Dữ liệu tuỳ ý và 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ã của một đơn vị tổ chức được chỉ định thiết bị sau khi đăng ký. Sau khi thiết bị được đă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 dài tối đa 1024 ký tự; 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 bản đại diện java.util.Properties được chuyển đổi tuần tự của 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 dùng nữa và giá trị này bị bỏ qua.

allowPersonalUsage

enum (AllowPersonalUsage)

Kiểm soát việc có cho 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 các thiết bị thuộc sở hữu của công ty:

  • Việc bật chế độ sử dụng cá nhân sẽ cho phép người dùng 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ị đó làm 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:

  • Việc bật chế độ sử dụng cá nhân sẽ cho phép người dùng 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ẽ khiến thiết bị 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ị của bạ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ột mã thông báo đăng ký còn hiệu lực 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 của một doanh nghiệp cụ thể.