Enrollmenttokens: create

Tạo mã đăng ký cho doanh nghiệp. Phương thức này thuộc EnrollmentTokensService.

Yêu cầu

Yêu cầu HTTP

POST https://www.googleapis.com/androidenterprise/v1/enterprises/enterpriseId/enrollmentTokens

Thông số

Tên thông số Giá trị Mô tả
Tham số đường dẫn
enterpriseId string Mã nhận dạng của doanh nghiệp.

Ủy quyền

Yêu cầu này cần được uỷ quyền với phạm vi sau:

Phạm vi
https://www.googleapis.com/auth/androidenterprise

Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.

Nội dung yêu cầu

Trong phần nội dung yêu cầu, hãy cung cấp dữ liệu có cấu trúc sau:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Tên tài sản Giá trị Mô tả Ghi chú
kind string
token 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à một trường chỉ đọc do máy chủ tạo.
enrollmentTokenType string [Bắt buộc] Loại mã thông báo đăng ký.

Các giá trị được chấp nhận là:
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [Không bắt buộc] Khoảng thời gian mã thông báo đă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 là 1 giờ.
duration.seconds long Số giây đã ký của khoảng thời gian.
googleAuthenticationOptions nested object [Không bắt buộc] Cung cấp các lựa chọn liên quan đến việc xác thực bằng Google trong quá trình đăng ký.
googleAuthenticationOptions.authenticationRequirement string [Không bắt buộc] Chỉ định việc người dùng có cần xác thực bằng Google trong quá trình đăng ký hay không. Nếu được cung cấp, sẽ ghi đè GoogleAuthenticationSettings cho tài nguyên doanh nghiệp khi thiết bị được đăng ký bằng mã thông báo này.

Các giá trị được chấp nhận là:
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
googleAuthenticationOptions.requiredAccountEmail string [Không bắt buộc] Chỉ định Tài khoản Google được quản lý mà người dùng phải sử dụng trong quá trình đăng ký. Bạn phải đặt AuthenticationRequirement thành REQUIRED nếu đặt trường này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về một phần nội dung phản hồi có cấu trúc sau:

{
  "kind": "androidenterprise#enrollmentToken",
  "token": string,
  "enrollmentTokenType": string,
  "duration": {
    "seconds": long,
    "nanos": integer
  },
  "googleAuthenticationOptions": {
    "authenticationRequirement": string,
    "requiredAccountEmail": string
  }
}
Tên tài sản Giá trị Mô tả Ghi chú
kind string
token 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à một trường chỉ đọc do máy chủ tạo.
enrollmentTokenType string [Bắt buộc] Loại mã thông báo đăng ký.

Các giá trị được chấp nhận là:
  • "enrollmentTokenTypeUnspecified"
  • "userDevice"
  • "userlessDevice"
duration nested object [Không bắt buộc] Khoảng thời gian mã thông báo đă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 là 1 giờ.
duration.seconds long Số giây đã ký của khoảng thời gian.
googleAuthenticationOptions nested object [Không bắt buộc] Cung cấp các lựa chọn liên quan đến việc xác thực bằng Google trong quá trình đăng ký.
googleAuthenticationOptions.authenticationRequirement string [Không bắt buộc] Chỉ định việc người dùng có cần xác thực bằng Google trong quá trình đăng ký hay không. Nếu được chỉ định, chế độ cài đặt này sẽ bỏ qua GoogleAuthenticationSettings được chỉ định cho tài nguyên doanh nghiệp đối với các thiết bị đăng ký bằng mã thông báo này.

Các giá trị được chấp nhận là:
  • "authenticationRequirementUnspecified"
  • "optional"
  • "required"
googleAuthenticationOptions.requiredAccountEmail string [Không bắt buộc] Chỉ định Tài khoản Google được quản lý mà người dùng phải sử dụng trong quá trình đăng ký.Bạn phải đặt AuthenticationRequirement thànhREQUIRED if this field is set.