REST Resource: customers.configurations

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

Cấu hình thu thập các tùy chọn cấp phép cho thiết bị Android. Mỗi cấu hình kết hợp các nội dung sau:

  • Đã cài đặt trình điều khiển chính sách thiết bị EMM (DPC) trên các thiết bị này.
  • Chính sách EMM được thực thi trên thiết bị.
  • Siêu dữ liệu hiển thị trên thiết bị để giúp người dùng trong quá trình thiết lập.

Khách hàng có thể thêm số lượng cấu hình tuỳ theo nhu cầu. Tuy nhiên, chương trình thiết lập tự động hoạt động hiệu quả nhất khi khách hàng đặ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
}
Các trường
name

string

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

configurationId

string (int64 format)

Chỉ đầ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 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

Phần bổ sung EMM định dạng JSON được truyền đến DPC.

companyName

string

Bắt buộc. Tên của tổ chức. Chương trình thiết lập tự động sẽ hiện 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ệ để được trợ giúp. Chương 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, dùng thiết bị khác, để yêu cầu trợ giúp. Chương trình thiết lập tự động sẽ cho thấy số điện thoại này cho người dùng thiết bị trước khi cấp phép cho 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

Thông báo gồm một hoặc hai câu để giúp người dùng thiết bị nhận trợ giúp hoặc cung cấp thêm chi tiết về những gì đang xảy ra với thiết bị của họ. Chương trình thiết lập tự động sẽ hiện 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à 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 của khách hàng làm mặc định. Khi bạn đặt giá trị này thành true, hệ thống sẽ thay đổi giá trị isDefault của cấu hình mặc định trước đó thành false.

forcedResetTime

string (Duration format)

Không bắt buộc. Thời gian chờ trước khi buộc khôi phục cài đặt gốc cho thiết bị 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 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-6 giờ, với 2 giờ là mặc định nếu không được đặt.

Thời lượng tính bằng giây, có tối đa 9 chữ số thập phân, kết thúc bằng "s". Ví dụ: "3.5s".

Phương thức

create

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

delete

Xóa cấu hình không sử dụng.

get

Xem chi tiế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 giá trị trường của cấu hình.