REST Resource: customers.configurations
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
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
|
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 |
|
|
Tạo một cấu hình mới. |
|
|
Xoá một cấu hình không dùng đến. |
|
|
Lấy thông tin chi tiết của một cấu hình. |
|
|
Liệt kê các cấu hình của khách hàng. |
|
|
Cập nhật các giá trị trường của cấu hình. |
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[[["\u003cp\u003eA configuration combines the EMM device policy controller, enforced policies, and setup metadata for Android devices.\u003c/p\u003e\n"],["\u003cp\u003eCustomers can create multiple configurations, but setting a default configuration is recommended for newly purchased devices.\u003c/p\u003e\n"],["\u003cp\u003eEach configuration includes details like the configuration name, DPC resource path, company information, and contact details for user assistance.\u003c/p\u003e\n"],["\u003cp\u003eThe JSON representation of a configuration details its properties such as \u003ccode\u003ename\u003c/code\u003e, \u003ccode\u003econfigurationId\u003c/code\u003e, \u003ccode\u003econfigurationName\u003c/code\u003e, \u003ccode\u003edpcResourcePath\u003c/code\u003e, \u003ccode\u003edpcExtras\u003c/code\u003e, \u003ccode\u003ecompanyName\u003c/code\u003e, \u003ccode\u003econtactEmail\u003c/code\u003e, \u003ccode\u003econtactPhone\u003c/code\u003e, \u003ccode\u003ecustomMessage\u003c/code\u003e, \u003ccode\u003eisDefault\u003c/code\u003e, and \u003ccode\u003eforcedResetTime\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eMethods are available to create, delete, get, list, and update device configurations.\u003c/p\u003e\n"]]],["Configurations are used to manage Android device provisioning, combining the EMM device policy controller (DPC), EMM policies, and setup metadata. Key information includes the `configurationName`, `dpcResourcePath`, `companyName`, `contactEmail`, `contactPhone`, and `customMessage`. The `isDefault` field designates the default configuration. Methods allow to create, delete, get, list, and patch configurations. A configuration uses a `forcedResetTime` for factory reset if the device does not get provisioned.\n"],null,["# REST Resource: customers.configurations\n\n- [Resource: Configuration](#Configuration)\n - [JSON representation](#Configuration.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: Configuration\n-----------------------\n\nA configuration collects the provisioning options for Android devices. Each configuration combines the following:\n\n- The EMM device policy controller (DPC) installed on the devices.\n- EMM policies enforced on the devices.\n- Metadata displayed on the device to help users during setup.\n\nCustomers can add as many configurations as they need. However, zero-touch enrollment works best when a customer sets a default configuration that's applied to any new devices the organization purchases.\n\n| JSON representation ||\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"name\": string, \"configurationId\": string, \"configurationName\": string, \"dpcResourcePath\": string, \"dpcExtras\": string, \"companyName\": string, \"contactEmail\": string, \"contactPhone\": string, \"customMessage\": string, \"isDefault\": boolean, \"forcedResetTime\": string } ``` |\n\n| Fields ||\n|---------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Output only. The API resource name in the format `customers/[CUSTOMER_ID]/configurations/[CONFIGURATION_ID]`. Assigned by the server. |\n| `configurationId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Output only. The ID of the configuration. Assigned by the server. |\n| `configurationName` | `string` Required. A short name that describes the configuration's purpose. For example, *Sales team* or *Temporary employees*. The zero-touch enrollment portal displays this name to IT admins. |\n| `dpcResourcePath` | `string` Required. The resource name of the selected DPC (device policy controller) in the format `customers/[CUSTOMER_ID]/dpcs/*`. To list the supported DPCs, call [`customers.dpcs.list`](/zero-touch/reference/customer/rest/v1/customers.dpcs/list#google.android.device.provisioning.v1.customer.DeviceProvisioningCustomerService.ListDpcs). |\n| `dpcExtras` | `string` The JSON-formatted EMM provisioning extras that are passed to the DPC. |\n| `companyName` | `string` Required. The name of the organization. Zero-touch enrollment shows this organization name to device users during device provisioning. |\n| `contactEmail` | `string` Required. The email address that device users can contact to get help. Zero-touch enrollment shows this email address to device users before device provisioning. The value is validated on input. |\n| `contactPhone` | `string` Required. The telephone number that device users can call, using another device, to get help. Zero-touch enrollment shows this number to device users before device provisioning. Accepts numerals, spaces, the plus sign, hyphens, and parentheses. |\n| `customMessage` | `string` A message, containing one or two sentences, to help device users get help or give them more details about what's happening to their device. Zero-touch enrollment shows this message before the device is provisioned. |\n| `isDefault` | `boolean` Required. Whether this is the default configuration that zero-touch enrollment applies to any new devices the organization purchases in the future. Only one customer configuration can be the default. Setting this value to `true`, changes the previous default configuration's `isDefault` value to `false`. |\n| `forcedResetTime` | `string (`[Duration](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Duration)` format)` Optional. The timeout before forcing factory reset the device if the device doesn't go through provisioning in the setup wizard, usually due to lack of network connectivity during setup wizard. Ranges from 0-6 hours, with 2 hours being the default if unset. A duration in seconds with up to nine fractional digits, ending with '`s`'. Example: `\"3.5s\"`. |\n\n| Methods ------- ||\n|--------------------------------------------------------------------------------------|-----------------------------------------|\n| ### [create](/zero-touch/reference/customer/rest/v1/customers.configurations/create) | Creates a new configuration. |\n| ### [delete](/zero-touch/reference/customer/rest/v1/customers.configurations/delete) | Deletes an unused configuration. |\n| ### [get](/zero-touch/reference/customer/rest/v1/customers.configurations/get) | Gets the details of a configuration. |\n| ### [list](/zero-touch/reference/customer/rest/v1/customers.configurations/list) | Lists a customer's configurations. |\n| ### [patch](/zero-touch/reference/customer/rest/v1/customers.configurations/patch) | Updates a configuration's field values. |"]]
