You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardexpand all lines: docs/dyn/androidmanagement_v1.enterprises.policies.html
+16-8
Original file line number
Diff line number
Diff line change
@@ -166,14 +166,14 @@ <h3>Method Details</h3>
166
166
"A String",
167
167
],
168
168
"disabled": True or False, # Whether the app is disabled. When disabled, the app data is still preserved.
169
-
"extensionConfig": { # Configuration to enable an app as an extension app, with the capability of interacting with Android Device Policy offline. # Configuration to enable this app as an extension app, with the capability of interacting with Android Device Policy offline.This field can be set for at most one app.
169
+
"extensionConfig": { # Configuration to enable an app as an extension app, with the capability of interacting with Android Device Policy offline. For Android versions 13 and above, extension apps are exempt from battery restrictions so will not be placed into the restricted App Standby Bucket (https://developer.android.com/topic/performance/appstandby#restricted-bucket). Extensions apps are also protected against users clearing their data or force-closing the application, although admins can continue to use the clear app data command (https://developer.android.com/management/reference/rest/v1/enterprises.devices/issueCommand#CommandType) on extension apps if needed for Android 13 and above. # Configuration to enable this app as an extension app, with the capability of interacting with Android Device Policy offline.This field can be set for at most one app.
170
170
"notificationReceiver": "A String", # Fully qualified class name of the receiver service class for Android Device Policy to notify the extension app of any local command status updates.
171
171
"signingKeyFingerprintsSha256": [ # Hex-encoded SHA-256 hash of the signing certificate of the extension app. Only hexadecimal string representations of 64 characters are valid.If not specified, the signature for the corresponding package name is obtained from the Play Store instead.If this list is empty, the signature of the extension app on the device must match the signature obtained from the Play Store for the app to be able to communicate with Android Device Policy.If this list is not empty, the signature of the extension app on the device must match one of the entries in this list for the app to be able to communicate with Android Device Policy.In production use cases, it is recommended to leave this empty.
172
172
"A String",
173
173
],
174
174
},
175
175
"installType": "A String", # The type of installation to perform.
176
-
"lockTaskAllowed": True or False, # Whether the app is allowed to lock itself in full-screen mode. DEPRECATED. Use InstallType KIOSK or kioskCustomLauncherEnabled to to configure a dedicated device.
176
+
"lockTaskAllowed": True or False, # Whether the app is allowed to lock itself in full-screen mode. DEPRECATED. Use InstallType KIOSK or kioskCustomLauncherEnabled to configure a dedicated device.
177
177
"managedConfiguration": { # Managed configuration applied to the app. The format for the configuration is dictated by the ManagedProperty values supported by the app. Each field name in the managed configuration must match the key field of the ManagedProperty. The field value must be compatible with the type of the ManagedProperty: *type* *JSON value* BOOL true or false STRING string INTEGER number CHOICE string MULTISELECT array of strings HIDDEN string BUNDLE_ARRAY array of objects
178
178
"a_key": "", # Properties of the object.
179
179
},
@@ -191,6 +191,7 @@ <h3>Method Details</h3>
191
191
"policy": "A String", # The policy for granting the permission.
192
192
},
193
193
],
194
+
"workProfileWidgets": "A String", # Specifies whether the app installed in the work profile is allowed to add widgets to the home screen.
194
195
},
195
196
],
196
197
"autoDateAndTimeZone": "A String", # Whether auto date, time, and time zone are enabled on a company-owned device. If this is set, then autoTimeRequired is ignored.
@@ -233,6 +234,7 @@ <h3>Method Details</h3>
233
234
"crossProfileCopyPaste": "A String", # Whether text copied from one profile (personal or work) can be pasted in the other profile.
234
235
"crossProfileDataSharing": "A String", # Whether data from one profile (personal or work) can be shared with apps in the other profile. Specifically controls simple data sharing via intents. Management of other cross-profile communication channels, such as contact search, copy/paste, or connected work & personal apps, are configured separately.
235
236
"showWorkContactsInPersonalProfile": "A String", # Whether contacts stored in the work profile can be shown in personal profile contact searches and incoming calls.
237
+
"workProfileWidgetsDefault": "A String", # Specifies the default behaviour for work profile widgets. If the policy does not specify work_profile_widgets for a specific application, it will behave according to the value specified here.
236
238
},
237
239
"dataRoamingDisabled": True or False, # Whether roaming data services are disabled.
238
240
"debuggingFeaturesAllowed": True or False, # Whether the user is allowed to enable debugging features.
@@ -545,14 +547,14 @@ <h3>Method Details</h3>
545
547
"A String",
546
548
],
547
549
"disabled": True or False, # Whether the app is disabled. When disabled, the app data is still preserved.
548
-
"extensionConfig": { # Configuration to enable an app as an extension app, with the capability of interacting with Android Device Policy offline. # Configuration to enable this app as an extension app, with the capability of interacting with Android Device Policy offline.This field can be set for at most one app.
550
+
"extensionConfig": { # Configuration to enable an app as an extension app, with the capability of interacting with Android Device Policy offline. For Android versions 13 and above, extension apps are exempt from battery restrictions so will not be placed into the restricted App Standby Bucket (https://developer.android.com/topic/performance/appstandby#restricted-bucket). Extensions apps are also protected against users clearing their data or force-closing the application, although admins can continue to use the clear app data command (https://developer.android.com/management/reference/rest/v1/enterprises.devices/issueCommand#CommandType) on extension apps if needed for Android 13 and above. # Configuration to enable this app as an extension app, with the capability of interacting with Android Device Policy offline.This field can be set for at most one app.
549
551
"notificationReceiver": "A String", # Fully qualified class name of the receiver service class for Android Device Policy to notify the extension app of any local command status updates.
550
552
"signingKeyFingerprintsSha256": [ # Hex-encoded SHA-256 hash of the signing certificate of the extension app. Only hexadecimal string representations of 64 characters are valid.If not specified, the signature for the corresponding package name is obtained from the Play Store instead.If this list is empty, the signature of the extension app on the device must match the signature obtained from the Play Store for the app to be able to communicate with Android Device Policy.If this list is not empty, the signature of the extension app on the device must match one of the entries in this list for the app to be able to communicate with Android Device Policy.In production use cases, it is recommended to leave this empty.
551
553
"A String",
552
554
],
553
555
},
554
556
"installType": "A String", # The type of installation to perform.
555
-
"lockTaskAllowed": True or False, # Whether the app is allowed to lock itself in full-screen mode. DEPRECATED. Use InstallType KIOSK or kioskCustomLauncherEnabled to to configure a dedicated device.
557
+
"lockTaskAllowed": True or False, # Whether the app is allowed to lock itself in full-screen mode. DEPRECATED. Use InstallType KIOSK or kioskCustomLauncherEnabled to configure a dedicated device.
556
558
"managedConfiguration": { # Managed configuration applied to the app. The format for the configuration is dictated by the ManagedProperty values supported by the app. Each field name in the managed configuration must match the key field of the ManagedProperty. The field value must be compatible with the type of the ManagedProperty: *type* *JSON value* BOOL true or false STRING string INTEGER number CHOICE string MULTISELECT array of strings HIDDEN string BUNDLE_ARRAY array of objects
557
559
"a_key": "", # Properties of the object.
558
560
},
@@ -570,6 +572,7 @@ <h3>Method Details</h3>
570
572
"policy": "A String", # The policy for granting the permission.
571
573
},
572
574
],
575
+
"workProfileWidgets": "A String", # Specifies whether the app installed in the work profile is allowed to add widgets to the home screen.
573
576
},
574
577
],
575
578
"autoDateAndTimeZone": "A String", # Whether auto date, time, and time zone are enabled on a company-owned device. If this is set, then autoTimeRequired is ignored.
@@ -612,6 +615,7 @@ <h3>Method Details</h3>
612
615
"crossProfileCopyPaste": "A String", # Whether text copied from one profile (personal or work) can be pasted in the other profile.
613
616
"crossProfileDataSharing": "A String", # Whether data from one profile (personal or work) can be shared with apps in the other profile. Specifically controls simple data sharing via intents. Management of other cross-profile communication channels, such as contact search, copy/paste, or connected work & personal apps, are configured separately.
614
617
"showWorkContactsInPersonalProfile": "A String", # Whether contacts stored in the work profile can be shown in personal profile contact searches and incoming calls.
618
+
"workProfileWidgetsDefault": "A String", # Specifies the default behaviour for work profile widgets. If the policy does not specify work_profile_widgets for a specific application, it will behave according to the value specified here.
615
619
},
616
620
"dataRoamingDisabled": True or False, # Whether roaming data services are disabled.
617
621
"debuggingFeaturesAllowed": True or False, # Whether the user is allowed to enable debugging features.
@@ -930,14 +934,14 @@ <h3>Method Details</h3>
930
934
"A String",
931
935
],
932
936
"disabled": True or False, # Whether the app is disabled. When disabled, the app data is still preserved.
933
-
"extensionConfig": { # Configuration to enable an app as an extension app, with the capability of interacting with Android Device Policy offline. # Configuration to enable this app as an extension app, with the capability of interacting with Android Device Policy offline.This field can be set for at most one app.
937
+
"extensionConfig": { # Configuration to enable an app as an extension app, with the capability of interacting with Android Device Policy offline. For Android versions 13 and above, extension apps are exempt from battery restrictions so will not be placed into the restricted App Standby Bucket (https://developer.android.com/topic/performance/appstandby#restricted-bucket). Extensions apps are also protected against users clearing their data or force-closing the application, although admins can continue to use the clear app data command (https://developer.android.com/management/reference/rest/v1/enterprises.devices/issueCommand#CommandType) on extension apps if needed for Android 13 and above. # Configuration to enable this app as an extension app, with the capability of interacting with Android Device Policy offline.This field can be set for at most one app.
934
938
"notificationReceiver": "A String", # Fully qualified class name of the receiver service class for Android Device Policy to notify the extension app of any local command status updates.
935
939
"signingKeyFingerprintsSha256": [ # Hex-encoded SHA-256 hash of the signing certificate of the extension app. Only hexadecimal string representations of 64 characters are valid.If not specified, the signature for the corresponding package name is obtained from the Play Store instead.If this list is empty, the signature of the extension app on the device must match the signature obtained from the Play Store for the app to be able to communicate with Android Device Policy.If this list is not empty, the signature of the extension app on the device must match one of the entries in this list for the app to be able to communicate with Android Device Policy.In production use cases, it is recommended to leave this empty.
936
940
"A String",
937
941
],
938
942
},
939
943
"installType": "A String", # The type of installation to perform.
940
-
"lockTaskAllowed": True or False, # Whether the app is allowed to lock itself in full-screen mode. DEPRECATED. Use InstallType KIOSK or kioskCustomLauncherEnabled to to configure a dedicated device.
944
+
"lockTaskAllowed": True or False, # Whether the app is allowed to lock itself in full-screen mode. DEPRECATED. Use InstallType KIOSK or kioskCustomLauncherEnabled to configure a dedicated device.
941
945
"managedConfiguration": { # Managed configuration applied to the app. The format for the configuration is dictated by the ManagedProperty values supported by the app. Each field name in the managed configuration must match the key field of the ManagedProperty. The field value must be compatible with the type of the ManagedProperty: *type* *JSON value* BOOL true or false STRING string INTEGER number CHOICE string MULTISELECT array of strings HIDDEN string BUNDLE_ARRAY array of objects
942
946
"a_key": "", # Properties of the object.
943
947
},
@@ -955,6 +959,7 @@ <h3>Method Details</h3>
955
959
"policy": "A String", # The policy for granting the permission.
956
960
},
957
961
],
962
+
"workProfileWidgets": "A String", # Specifies whether the app installed in the work profile is allowed to add widgets to the home screen.
958
963
},
959
964
],
960
965
"autoDateAndTimeZone": "A String", # Whether auto date, time, and time zone are enabled on a company-owned device. If this is set, then autoTimeRequired is ignored.
@@ -997,6 +1002,7 @@ <h3>Method Details</h3>
997
1002
"crossProfileCopyPaste": "A String", # Whether text copied from one profile (personal or work) can be pasted in the other profile.
998
1003
"crossProfileDataSharing": "A String", # Whether data from one profile (personal or work) can be shared with apps in the other profile. Specifically controls simple data sharing via intents. Management of other cross-profile communication channels, such as contact search, copy/paste, or connected work & personal apps, are configured separately.
999
1004
"showWorkContactsInPersonalProfile": "A String", # Whether contacts stored in the work profile can be shown in personal profile contact searches and incoming calls.
1005
+
"workProfileWidgetsDefault": "A String", # Specifies the default behaviour for work profile widgets. If the policy does not specify work_profile_widgets for a specific application, it will behave according to the value specified here.
1000
1006
},
1001
1007
"dataRoamingDisabled": True or False, # Whether roaming data services are disabled.
1002
1008
"debuggingFeaturesAllowed": True or False, # Whether the user is allowed to enable debugging features.
@@ -1298,14 +1304,14 @@ <h3>Method Details</h3>
1298
1304
"A String",
1299
1305
],
1300
1306
"disabled": True or False, # Whether the app is disabled. When disabled, the app data is still preserved.
1301
-
"extensionConfig": { # Configuration to enable an app as an extension app, with the capability of interacting with Android Device Policy offline. # Configuration to enable this app as an extension app, with the capability of interacting with Android Device Policy offline.This field can be set for at most one app.
1307
+
"extensionConfig": { # Configuration to enable an app as an extension app, with the capability of interacting with Android Device Policy offline. For Android versions 13 and above, extension apps are exempt from battery restrictions so will not be placed into the restricted App Standby Bucket (https://developer.android.com/topic/performance/appstandby#restricted-bucket). Extensions apps are also protected against users clearing their data or force-closing the application, although admins can continue to use the clear app data command (https://developer.android.com/management/reference/rest/v1/enterprises.devices/issueCommand#CommandType) on extension apps if needed for Android 13 and above. # Configuration to enable this app as an extension app, with the capability of interacting with Android Device Policy offline.This field can be set for at most one app.
1302
1308
"notificationReceiver": "A String", # Fully qualified class name of the receiver service class for Android Device Policy to notify the extension app of any local command status updates.
1303
1309
"signingKeyFingerprintsSha256": [ # Hex-encoded SHA-256 hash of the signing certificate of the extension app. Only hexadecimal string representations of 64 characters are valid.If not specified, the signature for the corresponding package name is obtained from the Play Store instead.If this list is empty, the signature of the extension app on the device must match the signature obtained from the Play Store for the app to be able to communicate with Android Device Policy.If this list is not empty, the signature of the extension app on the device must match one of the entries in this list for the app to be able to communicate with Android Device Policy.In production use cases, it is recommended to leave this empty.
1304
1310
"A String",
1305
1311
],
1306
1312
},
1307
1313
"installType": "A String", # The type of installation to perform.
1308
-
"lockTaskAllowed": True or False, # Whether the app is allowed to lock itself in full-screen mode. DEPRECATED. Use InstallType KIOSK or kioskCustomLauncherEnabled to to configure a dedicated device.
1314
+
"lockTaskAllowed": True or False, # Whether the app is allowed to lock itself in full-screen mode. DEPRECATED. Use InstallType KIOSK or kioskCustomLauncherEnabled to configure a dedicated device.
1309
1315
"managedConfiguration": { # Managed configuration applied to the app. The format for the configuration is dictated by the ManagedProperty values supported by the app. Each field name in the managed configuration must match the key field of the ManagedProperty. The field value must be compatible with the type of the ManagedProperty: *type* *JSON value* BOOL true or false STRING string INTEGER number CHOICE string MULTISELECT array of strings HIDDEN string BUNDLE_ARRAY array of objects
1310
1316
"a_key": "", # Properties of the object.
1311
1317
},
@@ -1323,6 +1329,7 @@ <h3>Method Details</h3>
1323
1329
"policy": "A String", # The policy for granting the permission.
1324
1330
},
1325
1331
],
1332
+
"workProfileWidgets": "A String", # Specifies whether the app installed in the work profile is allowed to add widgets to the home screen.
1326
1333
},
1327
1334
],
1328
1335
"autoDateAndTimeZone": "A String", # Whether auto date, time, and time zone are enabled on a company-owned device. If this is set, then autoTimeRequired is ignored.
@@ -1365,6 +1372,7 @@ <h3>Method Details</h3>
1365
1372
"crossProfileCopyPaste": "A String", # Whether text copied from one profile (personal or work) can be pasted in the other profile.
1366
1373
"crossProfileDataSharing": "A String", # Whether data from one profile (personal or work) can be shared with apps in the other profile. Specifically controls simple data sharing via intents. Management of other cross-profile communication channels, such as contact search, copy/paste, or connected work & personal apps, are configured separately.
1367
1374
"showWorkContactsInPersonalProfile": "A String", # Whether contacts stored in the work profile can be shown in personal profile contact searches and incoming calls.
1375
+
"workProfileWidgetsDefault": "A String", # Specifies the default behaviour for work profile widgets. If the policy does not specify work_profile_widgets for a specific application, it will behave according to the value specified here.
1368
1376
},
1369
1377
"dataRoamingDisabled": True or False, # Whether roaming data services are disabled.
1370
1378
"debuggingFeaturesAllowed": True or False, # Whether the user is allowed to enable debugging features.
"description": "Whether the app is allowed to lock itself in full-screen mode. DEPRECATED. Use InstallType KIOSK or kioskCustomLauncherEnabled to to configure a dedicated device.",
1636
+
"description": "Whether the app is allowed to lock itself in full-screen mode. DEPRECATED. Use InstallType KIOSK or kioskCustomLauncherEnabled to configure a dedicated device.",
1637
1637
"type": "boolean"
1638
1638
},
1639
1639
"managedConfiguration": {
@@ -1663,6 +1663,20 @@
1663
1663
"$ref": "PermissionGrant"
1664
1664
},
1665
1665
"type": "array"
1666
+
},
1667
+
"workProfileWidgets": {
1668
+
"description": "Specifies whether the app installed in the work profile is allowed to add widgets to the home screen.",
1669
+
"enum": [
1670
+
"WORK_PROFILE_WIDGETS_UNSPECIFIED",
1671
+
"WORK_PROFILE_WIDGETS_ALLOWED",
1672
+
"WORK_PROFILE_WIDGETS_DISALLOWED"
1673
+
],
1674
+
"enumDescriptions": [
1675
+
"Unspecified. Defaults to work_profile_widgets_default",
1676
+
"Work profile widgets are allowed. This means the application will be able to add widgets to the home screen.",
1677
+
"Work profile widgets are disallowed. This means the application will not be able to add widgets to the home screen."
1678
+
],
1679
+
"type": "string"
1666
1680
}
1667
1681
},
1668
1682
"type": "object"
@@ -2179,6 +2193,20 @@
2179
2193
"Default. Allows work profile contacts to appear in personal profile contact searches and incoming calls"
2180
2194
],
2181
2195
"type": "string"
2196
+
},
2197
+
"workProfileWidgetsDefault": {
2198
+
"description": "Specifies the default behaviour for work profile widgets. If the policy does not specify work_profile_widgets for a specific application, it will behave according to the value specified here.",
2199
+
"enum": [
2200
+
"WORK_PROFILE_WIDGETS_DEFAULT_UNSPECIFIED",
2201
+
"WORK_PROFILE_WIDGETS_DEFAULT_ALLOWED",
2202
+
"WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED"
2203
+
],
2204
+
"enumDescriptions": [
2205
+
"Unspecified. Defaults to WORK_PROFILE_WIDGETS_DEFAULT_DISALLOWED.",
2206
+
"Work profile widgets are allowed by default. This means that if the policy does not specify work_profile_widgets as WORK_PROFILE_WIDGETS_DISALLOWED for the application, it will be able to add widgets to the home screen.",
2207
+
"Work profile widgets are disallowed by default. This means that if the policy does not specify work_profile_widgets as WORK_PROFILE_WIDGETS_ALLOWED for the application, it will be unable to add widgets to the home screen."
2208
+
],
2209
+
"type": "string"
2182
2210
}
2183
2211
},
2184
2212
"type": "object"
@@ -2717,7 +2745,7 @@
2717
2745
"type": "object"
2718
2746
},
2719
2747
"ExtensionConfig": {
2720
-
"description": "Configuration to enable an app as an extension app, with the capability of interacting with Android Device Policy offline.",
2748
+
"description": "Configuration to enable an app as an extension app, with the capability of interacting with Android Device Policy offline. For Android versions 13 and above, extension apps are exempt from battery restrictions so will not be placed into the restricted App Standby Bucket (https://developer.android.com/topic/performance/appstandby#restricted-bucket). Extensions apps are also protected against users clearing their data or force-closing the application, although admins can continue to use the clear app data command (https://developer.android.com/management/reference/rest/v1/enterprises.devices/issueCommand#CommandType) on extension apps if needed for Android 13 and above.",
0 commit comments