Resource: Configuration
A configuration collects the provisioning options for Android devices. Each configuration combines the following:
- The EMM device policy controller (DPC) installed on the devices.
- EMM policies enforced on the devices.
- Metadata displayed on the device to help users during setup.
Customers 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.
JSON representation | |
---|---|
{ "name": string, "configurationId": string, "configurationName": string, "dpcResourcePath": string, "dpcExtras": string, "companyName": string, "contactEmail": string, "contactPhone": string, "customMessage": string, "isDefault": boolean } |
Fields | |
---|---|
name |
Output only. The API resource name in the format |
configurationId |
Output only. The ID of the configuration. Assigned by the server. |
configurationName |
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. |
dpcResourcePath |
Required. The resource name of the selected DPC (device policy controller) in the format |
dpcExtras |
The JSON-formatted EMM provisioning extras that are passed to the DPC. |
companyName |
Required. The name of the organization. Zero-touch enrollment shows this organization name to device users during device provisioning. |
contactEmail |
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. |
contactPhone |
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. |
customMessage |
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. |
isDefault |
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 |
Methods |
|
---|---|
|
Creates a new configuration. |
|
Deletes an unused configuration. |
|
Gets the details of a configuration. |
|
Lists a customer's configurations. |
|
Updates a configuration's field values. |