Api-roll 33: 2016-03-14

discovery/googleapis/androidenterprise__v1.json

 {
     "auth": {
         "oauth2": {
             "scopes": {
                 "https://www.googleapis.com/auth/androidenterprise": {
                     "description": "Manage corporate Android devices"
                 }
             }
         }
     },
     "basePath": "/androidenterprise/v1/",
     "baseUrl": "https://www.googleapis.com/androidenterprise/v1/",
     "batchPath": "batch",
     "canonicalName": "Android Enterprise",
     "description": "Allows MDMs/EMMs and enterprises to manage the deployment of apps to Android for Work users.",
     "discoveryVersion": "v1",
     "documentationLink": "https://developers.google.com/android/work/play/emm-api",
-    "etag": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/4xdfCsFKqY63nj0AgziCWDL1CtA\"",
+    "etag": "\"bRFOOrZKfO9LweMbPqu0kcu6De8/oDGCBWQ3TbSodDSQVvns_CkjrJY\"",
     "icons": {
         "x16": "https://www.google.com/images/icons/product/android-16.png",
         "x32": "https://www.google.com/images/icons/product/android-32.png"
     },
     "id": "androidenterprise:v1",
     "kind": "discovery#restDescription",
     "name": "androidenterprise",
     "ownerDomain": "google.com",
     "ownerName": "Google",
     "parameters": {
@@ skipping 548 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/androidenterprise"
                     ]
                 }
             }
         },
         "enterprises": {
             "methods": {
                 "delete": {
-                    "description": "Deletes the binding between the MDM and enterprise. This is now deprecated; use this to unenroll customers that were previously enrolled with the 'insert' call, then enroll them again with the 'enroll' call.",
+                    "description": "Deletes the binding between the EMM and enterprise. This is now deprecated; use this to unenroll customers that were previously enrolled with the 'insert' call, then enroll them again with the 'enroll' call.",
                     "httpMethod": "DELETE",
                     "id": "androidenterprise.enterprises.delete",
                     "parameterOrder": [
                         "enterpriseId"
                     ],
                     "parameters": {
                         "enterpriseId": {
                             "description": "The ID of the enterprise.",
                             "location": "path",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "enterprises/{enterpriseId}",
                     "scopes": [
                         "https://www.googleapis.com/auth/androidenterprise"
                     ]
                 },
                 "enroll": {
-                    "description": "Enrolls an enterprise with the calling MDM.",
+                    "description": "Enrolls an enterprise with the calling EMM.",
                     "httpMethod": "POST",
                     "id": "androidenterprise.enterprises.enroll",
                     "parameterOrder": [
                         "token"
                     ],
                     "parameters": {
                         "token": {
-                            "description": "The token provided by the enterprise to register the MDM.",
+                            "description": "The token provided by the enterprise to register the EMM.",
                             "location": "query",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "enterprises/enroll",
                     "request": {
                         "$ref": "Enterprise"
                     },
                     "response": {
@@ skipping 43 matching lines @@
                     },
                     "path": "enterprises/{enterpriseId}/storeLayout",
                     "response": {
                         "$ref": "StoreLayout"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/androidenterprise"
                     ]
                 },
                 "insert": {
-                    "description": "Establishes the binding between the MDM and an enterprise. This is now deprecated; use enroll instead.",
+                    "description": "Establishes the binding between the EMM and an enterprise. This is now deprecated; use enroll instead.",
                     "httpMethod": "POST",
                     "id": "androidenterprise.enterprises.insert",
                     "parameterOrder": [
                         "token"
                     ],
                     "parameters": {
                         "token": {
-                            "description": "The token provided by the enterprise to register the MDM.",
+                            "description": "The token provided by the enterprise to register the EMM.",
                             "location": "query",
                             "required": true,
                             "type": "string"
                         }
                     },
                     "path": "enterprises",
                     "request": {
                         "$ref": "Enterprise"
                     },
                     "response": {
@@ skipping 20 matching lines @@
                     },
                     "path": "enterprises",
                     "response": {
                         "$ref": "EnterprisesListResponse"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/androidenterprise"
                     ]
                 },
                 "sendTestPushNotification": {
-                    "description": "Sends a test push notification to validate the MDM integration with the Google Cloud Pub/Sub service for this enterprise.",
+                    "description": "Sends a test push notification to validate the EMM integration with the Google Cloud Pub/Sub service for this enterprise.",
                     "httpMethod": "POST",
                     "id": "androidenterprise.enterprises.sendTestPushNotification",
                     "parameterOrder": [
                         "enterpriseId"
                     ],
                     "parameters": {
                         "enterpriseId": {
                             "description": "The ID of the enterprise.",
                             "location": "path",
                             "required": true,
@@ skipping 54 matching lines @@
                         "$ref": "StoreLayout"
                     },
                     "response": {
                         "$ref": "StoreLayout"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/androidenterprise"
                     ]
                 },
                 "unenroll": {
-                    "description": "Unenrolls an enterprise from the calling MDM.",
+                    "description": "Unenrolls an enterprise from the calling EMM.",
                     "httpMethod": "POST",
                     "id": "androidenterprise.enterprises.unenroll",
                     "parameterOrder": [
                         "enterpriseId"
                     ],
                     "parameters": {
                         "enterpriseId": {
                             "description": "The ID of the enterprise.",
                             "location": "path",
                             "required": true,
@@ skipping 706 matching lines @@
                     },
                     "path": "enterprises/{enterpriseId}/products/{productId}/permissions",
                     "response": {
                         "$ref": "ProductPermissions"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/androidenterprise"
                     ]
                 },
                 "updatePermissions": {
-                    "description": "Updates the set of Android app permissions for this app that have been accepted by the enterprise.",
+                    "description": "This method has been deprecated. To programmatically approve applications, you must use the iframe mechanism via the  generateApprovalUrl and  approve methods of the Products resource. For more information, see the  Play EMM API usage requirements.\n\nThe updatePermissions method (deprecated) updates the set of Android app permissions for this app that have been accepted by the enterprise.",
                     "httpMethod": "PUT",
                     "id": "androidenterprise.products.updatePermissions",
                     "parameterOrder": [
                         "enterpriseId",
                         "productId"
                     ],
                     "parameters": {
                         "enterpriseId": {
                             "description": "The ID of the enterprise.",
                             "location": "path",
@@ skipping 410 matching lines @@
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/androidenterprise"
                     ]
                 }
             }
         },
         "users": {
             "methods": {
                 "generateToken": {
-                    "description": "Generates a token (activation code) to allow this user to configure their work account in the Android Setup Wizard. Revokes any previously generated token.",
+                    "description": "Generates a token (activation code) to allow this user to configure their work account in the Android Setup Wizard. Revokes any previously generated token.\n\nThis call only works with Google managed accounts.",
                     "httpMethod": "POST",
                     "id": "androidenterprise.users.generateToken",
                     "parameterOrder": [
                         "enterpriseId",
                         "userId"
                     ],
                     "parameters": {
                         "enterpriseId": {
                             "description": "The ID of the enterprise.",
                             "location": "path",
@@ skipping 69 matching lines @@
                     },
                     "path": "enterprises/{enterpriseId}/users/{userId}/availableProductSet",
                     "response": {
                         "$ref": "ProductSet"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/androidenterprise"
                     ]
                 },
                 "list": {
-                    "description": "Looks up a user by email address. This only works for Google managed users.",
+                    "description": "Looks up a user by their primary email address.",
                     "httpMethod": "GET",
                     "id": "androidenterprise.users.list",
                     "parameterOrder": [
                         "enterpriseId",
                         "email"
                     ],
                     "parameters": {
                         "email": {
                             "description": "The exact primary email address of the user to look up.",
                             "location": "query",
@@ skipping 71 matching lines @@
                     "response": {
                         "$ref": "ProductSet"
                     },
                     "scopes": [
                         "https://www.googleapis.com/auth/androidenterprise"
                     ]
                 }
             }
         }
     },
-    "revision": "20160106",
+    "revision": "20160302",
     "rootUrl": "https://www.googleapis.com/",
     "schemas": {
         "AppRestrictionsSchema": {
             "description": "Represents the list of app restrictions available to be pre-configured for the product.",
             "id": "AppRestrictionsSchema",
             "properties": {
                 "kind": {
                     "default": "androidenterprise#appRestrictionsSchema",
                     "description": "Identifies what kind of resource this is. Value: the fixed string \"androidenterprise#appRestrictionsSchema\".",
                     "type": "string"
@@ skipping 187 matching lines @@
                 },
                 "kind": {
                     "default": "androidenterprise#collectionsListResponse",
                     "description": "Identifies what kind of resource this is. Value: the fixed string \"androidenterprise#collectionsListResponse\".",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Device": {
-            "description": "A device resource represents a mobile device managed by the MDM and belonging to a specific enterprise user.\n\nThis collection cannot be modified via the API; it is automatically populated as devices are set up to be managed.",
+            "description": "A device resource represents a mobile device managed by the EMM and belonging to a specific enterprise user.\n\nThis collection cannot be modified via the API; it is automatically populated as devices are set up to be managed.",
             "id": "Device",
             "properties": {
                 "androidId": {
                     "description": "The Google Play Services Android ID for the device encoded as a lowercase hex string, e.g. \"123456789abcdef0\".",
                     "type": "string"
                 },
                 "kind": {
                     "default": "androidenterprise#device",
                     "description": "Identifies what kind of resource this is. Value: the fixed string \"androidenterprise#device\".",
                     "type": "string"
                 },
                 "managementType": {
-                    "description": "The mechanism by which this device is managed by the MDM. \"managedDevice\" means that the MDM's app is a device owner. \"managedProfile\" means that the MDM's app is the profile owner (and there is a separate personal profile which is not managed). \"containerApp\" means that the MDM's app is managing the Android for Work container app on the device.",
+                    "description": "The mechanism by which this device is managed by the EMM. \"managedDevice\" means that the EMM's app is a device owner. \"managedProfile\" means that the EMM's app is the profile owner (and there is a separate personal profile which is not managed). \"containerApp\" means that the EMM's app is managing the Android for Work container app on the device.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "DeviceState": {
             "description": "The state of a user's device, as accessed by the getState and setState methods on device resources.",
             "id": "DeviceState",
             "properties": {
                 "accountState": {
@@ skipping 21 matching lines @@
                 },
                 "kind": {
                     "default": "androidenterprise#devicesListResponse",
                     "description": "Identifies what kind of resource this is. Value: the fixed string \"androidenterprise#devicesListResponse\".",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Enterprise": {
-            "description": "An enterprise resource represents a binding between an organisation and their MDM.\n\nTo create an enterprise, an admin of the enterprise must first go through a Play for Work sign-up flow. At the end of this the admin will be presented with a token (a short opaque alphanumeric string). They must then present this to the MDM, who then supplies it to the enroll method. Until this is done the MDM will not have any access to the enterprise.\n\nAfter calling enroll the MDM should call setAccount to specify the service account that will be allowed to act on behalf of the enterprise, which will be required for access to the enterprise's data through this API. Only one call of setAccount is allowed for a given enterprise; the only way to change the account later is to unenroll the enterprise and enroll it again (obtaining a new token).\n\nThe MDM can unenroll an enterprise in order to sever the binding between them. Re-enrolling an enterprise is possible, but requires a new token to be retrieved. Enterprises.unenroll requires the MDM's credentials (as enroll does), not the enterprise's. Enterprises.unenroll can only be used for enterprises that were previously enrolled with the enroll call. Any enterprises that were enrolled using the (deprecated) Enterprises.insert call must be unenrolled with Enterprises.delete and can then be re-enrolled using the Enterprises.enroll call.\n\nThe ID for an enterprise is an opaque string. It is returned by insert and enroll and can also be retrieved if the enterprise's primary domain is known using the list method.",
+            "description": "An enterprise resource represents a binding between an organisation and their EMM.\n\nTo create an enterprise, an admin of the enterprise must first go through a Play for Work sign-up flow. At the end of this the admin will be presented with a token (a short opaque alphanumeric string). They must then present this to the EMM, who then supplies it to the enroll method. Until this is done the EMM will not have any access to the enterprise.\n\nAfter calling enroll the EMM should call setAccount to specify the service account that will be allowed to act on behalf of the enterprise, which will be required for access to the enterprise's data through this API. Only one call of setAccount is allowed for a given enterprise; the only way to change the account later is to unenroll the enterprise and enroll it again (obtaining a new token).\n\nThe EMM can unenroll an enterprise in order to sever the binding between them. Re-enrolling an enterprise is possible, but requires a new token to be retrieved. Enterprises.unenroll requires the EMM's credentials (as enroll does), not the enterprise's. Enterprises.unenroll can only be used for enterprises that were previously enrolled with the enroll call. Any enterprises that were enrolled using the (deprecated) Enterprises.insert call must be unenrolled with Enterprises.delete and can then be re-enrolled using the Enterprises.enroll call.\n\nThe ID for an enterprise is an opaque string. It is returned by insert and enroll and can also be retrieved if the enterprise's primary domain is known using the list method.",
             "id": "Enterprise",
             "properties": {
                 "id": {
                     "description": "The unique ID for the enterprise.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "androidenterprise#enterprise",
                     "description": "Identifies what kind of resource this is. Value: the fixed string \"androidenterprise#enterprise\".",
                     "type": "string"
@@ skipping 57 matching lines @@
                     "type": "string"
                 },
                 "topicName": {
                     "description": "The name of the Cloud Pub/Sub topic to which notifications for this enterprise's enrolled account will be sent.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Entitlement": {
-            "description": "The existence of an entitlement resource means that a user has the right to use a particular app on any of their devices. This might be because the app is free or because they have been allocated a license to the app from a group license purchased by the enterprise.\n\nIt should always be true that a user has an app installed on one of their devices only if they have an entitlement to it. So if an entitlement is deleted, the app will be uninstalled from all devices. Similarly if the user installs an app (and is permitted to do so), or the MDM triggers an install of the app, an entitlement to that app is automatically created. If this is impossible - e.g. the enterprise has not purchased sufficient licenses - then installation fails.\n\nNote that entitlements are always user specific, not device specific; a user may have an entitlement even though they have not installed the app anywhere. Once they have an entitlement they can install the app on multiple devices.\n\nThe API can be used to create an entitlement. If the app is a free app, a group license for that app is created. If it's a paid app, creating the entitlement consumes one license; it remains consumed until the entitlement is removed. Optionally an installation of the app on all the user's managed devices can be triggered at the time the entitlement is created. An entitlement cannot be created for an app if the app requires permissions that the enterprise has not yet accepted.\n\nEntitlements for paid apps that are due to purchases by the user on a non-managed profile will have \"userPurchase\" as entitlement reason; those entitlements cannot be removed via the API.",
+            "description": "The existence of an entitlement resource means that a user has the right to use a particular app on any of their devices. This might be because the app is free or because they have been allocated a license to the app from a group license purchased by the enterprise.\n\nIt should always be true that a user has an app installed on one of their devices only if they have an entitlement to it. So if an entitlement is deleted, the app will be uninstalled from all devices. Similarly if the user installs an app (and is permitted to do so), or the EMM triggers an install of the app, an entitlement to that app is automatically created. If this is impossible - e.g. the enterprise has not purchased sufficient licenses - then installation fails.\n\nNote that entitlements are always user specific, not device specific; a user may have an entitlement even though they have not installed the app anywhere. Once they have an entitlement they can install the app on multiple devices.\n\nThe API can be used to create an entitlement. If the app is a free app, a group license for that app is created. If it's a paid app, creating the entitlement consumes one license; it remains consumed until the entitlement is removed. Optionally an installation of the app on all the user's managed devices can be triggered at the time the entitlement is created. An entitlement cannot be created for an app if the app requires permissions that the enterprise has not yet accepted.\n\nEntitlements for paid apps that are due to purchases by the user on a non-managed profile will have \"userPurchase\" as entitlement reason; those entitlements cannot be removed via the API.",
             "id": "Entitlement",
             "properties": {
                 "kind": {
                     "default": "androidenterprise#entitlement",
                     "description": "Identifies what kind of resource this is. Value: the fixed string \"androidenterprise#entitlement\".",
                     "type": "string"
                 },
                 "productId": {
                     "description": "The ID of the product that the entitlement is for, e.g. \"app:com.google.android.gm\".",
                     "type": "string"
@@ skipping 149 matching lines @@
                     "type": "string"
                 },
                 "text": {
                     "description": "The text localized in the associated locale.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Permission": {
-            "description": "A permission represents some extra capability, to be granted to an Android app, which requires explicit consent. An enterprise admin must consent to these permissions on behalf of their users before an entitlement for the app can be created.\n\nThe permissions collection is read-only. The information provided for each permission (localized name and description) is intended to be used in the MDM user interface when obtaining consent from the enterprise.",
+            "description": "A permission represents some extra capability, to be granted to an Android app, which requires explicit consent. An enterprise admin must consent to these permissions on behalf of their users before an entitlement for the app can be created.\n\nThe permissions collection is read-only. The information provided for each permission (localized name and description) is intended to be used in the EMM user interface when obtaining consent from the enterprise.",
             "id": "Permission",
             "properties": {
                 "description": {
                     "description": "A longer description of the permissions giving more details of what it affects.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "androidenterprise#permission",
                     "description": "Identifies what kind of resource this is. Value: the fixed string \"androidenterprise#permission\".",
                     "type": "string"
                 },
                 "name": {
                     "description": "The name of the permission.",
                     "type": "string"
                 },
                 "permissionId": {
                     "description": "An opaque string uniquely identifying the permission.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "Product": {
-            "description": "A product represents an app in the Google Play Store that is available to at least some users in the enterprise. (Some apps are restricted to a single enterprise, and no information about them is made available outside that enterprise.)\n\nThe information provided for each product (localized name, icon, link to the full Google Play details page) is intended to allow a basic representation of the product within an MDM user interface.",
+            "description": "A product represents an app in the Google Play Store that is available to at least some users in the enterprise. (Some apps are restricted to a single enterprise, and no information about them is made available outside that enterprise.)\n\nThe information provided for each product (localized name, icon, link to the full Google Play details page) is intended to allow a basic representation of the product within an EMM user interface.",
             "id": "Product",
             "properties": {
                 "appVersion": {
                     "description": "App versions currently available for this product. The returned list contains only public versions. Alpha and beta versions are not included.",
                     "items": {
                         "$ref": "AppVersion"
                     },
                     "type": "array"
                 },
                 "authorName": {
@@ skipping 234 matching lines @@
                     "description": "Ordered list of localized strings giving the name of this page. The text displayed is the one that best matches the user locale, or the first entry if there is no good match. There needs to be at least one entry.",
                     "items": {
                         "$ref": "LocalizedText"
                     },
                     "type": "array"
                 }
             },
             "type": "object"
         },
         "User": {
-            "description": "A user resource represents an individual user within the enterprise's domain.\n\nNote that each user is associated with a Google account based on the user's corporate email address (which must be in one of the enterprise's domains). As part of installing an MDM app to manage a device the Google account must be provisioned to the device, and so the user resource must be created before that. This can be done using the Google Admin SDK Directory API.\n\nThe ID for a user is an opaque string. It can be retrieved using the list method queried by the user's primary email address.",
+            "description": "A user resource represents an individual user within the enterprise's domain.\n\nNote that each user is associated with a Google account based on the user's corporate email address (which must be in one of the enterprise's domains). As part of installing the EMM's DPC app to manage a device the Google account must be provisioned to the device, and so the user resource must be created before that. This can be done using the Google Admin SDK Directory API.\n\nThe ID for a user is an opaque string. It can be retrieved using the list method queried by the user's primary email address.",
             "id": "User",
             "properties": {
                 "id": {
                     "description": "The unique ID for the user.",
                     "type": "string"
                 },
                 "kind": {
                     "default": "androidenterprise#user",
                     "description": "Identifies what kind of resource this is. Value: the fixed string \"androidenterprise#user\".",
                     "type": "string"
                 },
                 "primaryEmail": {
                     "description": "The user's primary email, e.g. \"jsmith@example.com\". Will always be set for Google managed users and not set for EMM managed users.",
                     "type": "string"
                 }
             },
             "type": "object"
         },
         "UserToken": {
-            "description": "A UserToken is used by a user when setting up a managed device or profile with their work account on a device. When the user enters their email address and token (activation code) the appropriate MDM app can be automatically downloaded.",
+            "description": "A UserToken is used by a user when setting up a managed device or profile with their work account on a device. When the user enters their email address and token (activation code) the appropriate EMM app can be automatically downloaded.",
             "id": "UserToken",
             "properties": {
                 "kind": {
                     "default": "androidenterprise#userToken",
                     "description": "Identifies what kind of resource this is. Value: the fixed string \"androidenterprise#userToken\".",
                     "type": "string"
                 },
                 "token": {
                     "description": "The token (activation code) to be entered by the user. This consists of a sequence of decimal digits. Note that the leading digit may be 0.",
                     "type": "string"
@@ skipping 22 matching lines @@
                     "type": "array"
                 }
             },
             "type": "object"
         }
     },
     "servicePath": "androidenterprise/v1/",
     "title": "Google Play EMM API",
     "version": "v1"
 }