REST Resource: customers.configurations

Tài nguyên: Cấu hình

Một cấu hình thu thập các tuỳ chọn cấp phép cho thiết bị Android. Mỗi cấu hình kết hợp những tính năng sau:

  • Trình kiểm soát chính sách thiết bị (DPC) EMM đã cài đặt trên thiết bị.
  • Chính sách EMM được thực thi trên thiết bị.
  • Siêu dữ liệu xuất hiện trên thiết bị để hỗ trợ người dùng trong quá trình thiết lập.

Khách hàng có thể thêm bao nhiêu cấu hình tuỳ ý. Tuy nhiên, quy trình thiết lập tự động hoạt động hiệu quả nhất khi khách hàng đặt một cấu hình mặc định để áp dụng cho mọi thiết bị mới mà tổ chức mua.

Biểu diễn dưới dạng JSON 
{
  "name": string,
  "configurationId": string,
  "configurationName": string,
  "dpcResourcePath": string,
  "dpcExtras": string,
  "companyName": string,
  "contactEmail": string,
  "contactPhone": string,
  "customMessage": string,
  "isDefault": boolean,
  "forcedResetTime": string
}
Trường
name

string

Chỉ có đầu ra. Tên tài nguyên API ở định dạng customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]. Do máy chủ chỉ định.
configurationId

string (int64 format)

Chỉ có đầu ra. Mã của cấu hình. Do máy chủ chỉ định.
configurationName

string

Bắt buộc. Tên ngắn mô tả mục đích của cấu hình. Ví dụ: Nhóm bán hàng hoặc Nhân viên tạm thời. Cổng thông tin thiết lập tự động sẽ hiển thị tên này cho quản trị viên CNTT.
dpcResourcePath

string

Bắt buộc. Tên tài nguyên của DPC (trình kiểm soát chính sách thiết bị) đã chọn ở định dạng customers/[CUSTOMER_ID]/dpcs/*. Để liệt kê các DPC được hỗ trợ, hãy gọi customers.dpcs.list.
dpcExtras

string

Bổ sung cấp phép EMM theo định dạng JSON được truyền đến DPC.
companyName

string

Bắt buộc. Tên của tổ chức. Quy trình thiết lập tự động hiển thị tên tổ chức này cho người dùng thiết bị trong quá trình cấp phép thiết bị.
contactEmail

string

Bắt buộc. Địa chỉ email mà người dùng thiết bị có thể liên hệ để yêu cầu trợ giúp. Quy trình thiết lập tự động sẽ hiển thị địa chỉ email này cho người dùng thiết bị trước khi cấp phép thiết bị. Giá trị được xác thực khi nhập.
contactPhone

string

Bắt buộc. Số điện thoại mà người dùng thiết bị có thể gọi (thông qua một thiết bị khác) để yêu cầu trợ giúp. Quy trình thiết lập tự động sẽ hiển thị số này cho người dùng thiết bị trước khi cấp phép thiết bị. Chấp nhận chữ số, dấu cách, dấu cộng, dấu gạch nối và dấu ngoặc đơn.
customMessage

string

Một thông báo, bao gồm một hoặc hai câu, để giúp người dùng thiết bị được trợ giúp hoặc cung cấp cho họ thêm thông tin chi tiết về những gì đang xảy ra với thiết bị của họ. Quy trình thiết lập tự động sẽ hiển thị thông báo này trước khi thiết bị được cấp phép.
isDefault

boolean

Bắt buộc. Liệu đây có phải là cấu hình mặc định mà quy trình thiết lập tự động áp dụng cho mọi thiết bị mới mà tổ chức mua trong tương lai hay không. Chỉ có thể đặt một cấu hình mặc định cho khách hàng. Nếu bạn đặt giá trị này thành true, giá trị isDefault của cấu hình mặc định trước đó sẽ thay đổi thành false.
forcedResetTime

string (Duration format)

Không bắt buộc. Thời gian chờ trước khi buộc đặt lại thiết bị về trạng thái ban đầu nếu thiết bị không được cấp phép trong trình hướng dẫn thiết lập, thường là do thiếu kết nối mạng trong trình hướng dẫn thiết lập. Phạm vi từ 0 đến 6 giờ, trong đó 2 giờ là giá trị mặc định nếu bạn không đặt chính sách này.

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".

Phương thức

create

 Tạo một cấu hình mới.

delete

 Xoá một cấu hình không dùng đến.

get

 Lấy thông tin chi tiết của một cấu hình.

list

 Liệt kê các cấu hình của khách hàng.

patch

 Cập nhật các giá trị trường của cấu hình.