Page Summary
-
New integrations cannot use this method and should refer to the new recommendations.
-
This method will no longer be accessible by anyone after September 30, 2025.
-
A managed configuration resource contains the set of managed properties defined by the app developer in the app's managed configurations schema, as well as any configuration variables defined for the user.
-
The methods associated with this resource (delete, get, list, update) are also deprecated and will no longer be accessible after September 30, 2025.
For a list of methods for this resource, see the end of this page.
Resource representations
A managed configuration resource contains the set of managed properties defined by the app developer in the app's managed configurations schema, as well as any configuration variables defined for the user.
{ "kind" : string , "productId" : string , "managedProperty" : [ { "key" : string , "valueBool" : boolean , "valueInteger" : integer , "valueString" : string , "valueStringArray" : [ string ], "valueBundle" : { "managedProperty" : [ ( ManagedProperty ) ] } , "valueBundleArray" : [ { "managedProperty" : [ ( ManagedProperty ) ] } ] } ], "configurationVariables" : { "kind" : "androidenterprise#configurationVariables" , "mcmId" : string , "variableSet" : [ { "kind" : "androidenterprise#variableSet" , "placeholder" : string , "userValue" : string } ] } }
| Property name | Value | Description | Notes |
|---|---|---|---|
configurationVariables
|
nested object
|
Contains the ID of the managed configuration profile and the set of configuration variables (if any) defined for the user. | |
configurationVariables.
kind
|
string
|
||
configurationVariables.
mcmId
|
string
|
The ID of the managed configurations settings. | |
configurationVariables.
variableSet[]
|
list
|
The variable set that is attributed to the user. | |
configurationVariables.variableSet[].
kind
|
string
|
||
configurationVariables.variableSet[].
placeholder
|
string
|
The placeholder string; defined by EMM. | |
configurationVariables.variableSet[].
userValue
|
string
|
The value of the placeholder, specific to the user. | |
kind
|
string
|
Deprecated. |
|
managedProperty[]
|
list
|
The set of managed properties for this configuration. | |
managedProperty[].
key
|
string
|
The unique key that identifies the property. | |
managedProperty[].
valueBool
|
boolean
|
The boolean value - this will only be present if type of the property is bool. | |
managedProperty[].
valueBundle
|
nested object
|
The bundle of managed properties - this will only be present if type of the property is bundle. | |
managedProperty[].valueBundle.
managedProperty[]
|
list
|
The list of managed properties. | |
managedProperty[].
valueBundleArray[]
|
list
|
The list of bundles of properties - this will only be present if type of the property is bundle_array. | |
managedProperty[].valueBundleArray[].
managedProperty[]
|
list
|
The list of managed properties. | |
managedProperty[].
valueInteger
|
integer
|
The integer value - this will only be present if type of the property is integer. | |
managedProperty[].
valueString
|
string
|
The string value - this will only be present if type of the property is string, choice or hidden. | |
managedProperty[].
valueStringArray[]
|
list
|
The list of string values - this will only be present if type of the property is multiselect. | |
productId
|
string
|
The ID of the product that the managed configuration is for, e.g. "app:com.google.android.gm". |
Methods
- delete
- Removes a per-user managed configuration for an app for the specified user.
- get
- Retrieves details of a per-user managed configuration for an app for the specified user.
- list
- Lists all the per-user managed configurations for the specified user. Only the ID is set.
- update
-
Adds or updates the managed configuration settings for an app for the specified user.
If you support the Managed configurations iframe
,
you can apply managed configurations to a user by specifying an
mcmIdand its associated configuration variables (if any) in the request. Alternatively, all EMMs can apply managed configurations by passing a list of managed properties.
