Get
|
|||||
|
|
Retrieves details of a per-user managed configuration for an app for the specified user
Authorization
To use this building block you will have to grant access to at least one of the following scopes:
- Manage corporate Android devices
Input
This building block consumes 3 input parameters
Name | Format | Description |
---|---|---|
enterpriseId Required |
STRING |
The ID of the enterprise |
userId Required |
STRING |
The ID of the user |
managedConfigurationForUserId Required |
STRING |
The ID of the managed configuration (a product ID), e.g. "app:com.google.android.gm" |
= Parameter name
= Format
enterpriseId STRING Required The ID of the enterprise |
userId STRING Required The ID of the user |
managedConfigurationForUserId STRING Required The ID of the managed configuration (a product ID), e.g. "app:com.google.android.gm" |
Output
This building block provides 18 output parameters
Name | Format | Description |
---|---|---|
configurationVariables |
OBJECT |
A configuration variables resource contains the managed configuration settings ID to be applied to a single user, as well as the variable set that is attributed to the user. The variable set will be used to replace placeholders in the managed configuration settings |
configurationVariables.kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "androidenterprise#configurationVariables" |
configurationVariables.mcmId |
STRING |
The ID of the managed configurations settings |
configurationVariables.variableSet[] |
OBJECT |
A variable set is a key-value pair of EMM-provided placeholders and its corresponding value, which is attributed to a user. For example, $FIRSTNAME could be a placeholder, and its value could be Alice. Placeholders should start with a '$' sign and should be alphanumeric only |
configurationVariables.variableSet[].kind |
STRING |
Identifies what kind of resource this is. Value: the fixed string "androidenterprise#variableSet" |
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 |
Identifies what kind of resource this is. Value: the fixed string "androidenterprise#managedConfiguration" |
managedProperty[] |
OBJECT |
A managed property of a managed configuration. The property must match one of the properties in the app restrictions schema of the product. Exactly one of the value fields must be populated, and it must match the property's type in the app restrictions schema |
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 |
OBJECT |
A bundle of managed properties |
managedProperty[].valueBundle.managedProperty[] |
OBJECT |
A managed property of a managed configuration. The property must match one of the properties in the app restrictions schema of the product. Exactly one of the value fields must be populated, and it must match the property's type in the app restrictions schema |
managedProperty[].valueBundleArray[] |
OBJECT |
A bundle 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[] |
STRING |
|
productId |
STRING |
The ID of the product that the managed configuration is for, e.g. "app:com.google.android.gm" |
= Parameter name
= Format
configurationVariables OBJECT A configuration variables resource contains the managed configuration settings ID to be applied to a single user, as well as the variable set that is attributed to the user. The variable set will be used to replace placeholders in the managed configuration settings |
configurationVariables.kind STRING Identifies what kind of resource this is. Value: the fixed string "androidenterprise#configurationVariables" |
configurationVariables.mcmId STRING The ID of the managed configurations settings |
configurationVariables.variableSet[] OBJECT A variable set is a key-value pair of EMM-provided placeholders and its corresponding value, which is attributed to a user. For example, $FIRSTNAME could be a placeholder, and its value could be Alice. Placeholders should start with a '$' sign and should be alphanumeric only |
configurationVariables.variableSet[].kind STRING Identifies what kind of resource this is. Value: the fixed string "androidenterprise#variableSet" |
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 Identifies what kind of resource this is. Value: the fixed string "androidenterprise#managedConfiguration" |
managedProperty[] OBJECT A managed property of a managed configuration. The property must match one of the properties in the app restrictions schema of the product. Exactly one of the value fields must be populated, and it must match the property's type in the app restrictions schema |
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 OBJECT A bundle of managed properties |
managedProperty[].valueBundle.managedProperty[] OBJECT A managed property of a managed configuration. The property must match one of the properties in the app restrictions schema of the product. Exactly one of the value fields must be populated, and it must match the property's type in the app restrictions schema |
managedProperty[].valueBundleArray[] OBJECT A bundle 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[] STRING |
productId STRING The ID of the product that the managed configuration is for, e.g. "app:com.google.android.gm" |