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à:
|
|
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à:
|
|
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à:
|
|
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à:
|
|
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 |