Installing an Application on Android Devices

Description Install an application on an Android device. If the device you are installing the application on has the WSO2 system service installed, the application installation will happen in silent mode, else the device user's consent will be required.

Resource Path /install-application

URL

/mdm-android-agent/operation/install-application

HTTP Method POST

Request/Response Format application/json

cURL command

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer <EMM_API_TOKEN>" -d @'<JSON_PAYLOAD>' -k -v https://<EMM_HOST>:<EMM_HTTPS_PORT>/mdm-android-agent/operation/install-application

For more information on how to generate the EMM API token, see Generating the OAuth 2.0 Access Token.
Define the path to the <JSON_PAYLOAD>, which includes the required properties to carry out the operation, as the <JSON_PAYLOAD> value. For more information, see the Sample JSON Definition.
By default, <EMM_HOST> is localhost., However, if you are using a public IP, the respective IP address or domain needs to be specified.
By default, <EMM_HTTPS_PORT> has been set to 9443. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.

Example:

curl -X POST -H "Content-Type: application/json" -H "Authorization: Bearer e56974e8bf5df15748f89c6c5da9835d" -d @'operation.json' -k -v https://localhost:9443/mdm-android-agent/operation/install-application

Sample output

> POST /mdm-android-agent/operation/install-application HTTP/1.1
> User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0 OpenSSL/0.9.8| zlib/1.2.5
> Host: localhost:9443
> Accept: */*
> Content-Type: application/json
> Authorization: Bearer e56974e8bf5df15748f89c6c5da9835d
> Content-Length: 21
< HTTP/1.1 201 Created
< Date: Wed, 10 Jun 2015 10:19:38 GMT
< Content-Length: 0
< Server: WSO2 Carbon Server

Sample JSON Definition

Property Value	Description	Data Type
operation	This specifies the operation that is to be applied on the Android device.	-
`appIdentifier`	The package name of the application to be uninstalled. For more information on how to identify the package name of the application, see Retrieving the App Identifier of an Application. This property is not applicable for web apps (web clips) as a web app is a browser bookmark for an application.	String
`type`	The type of the application. The following types of applications are supported: enterprise, public and webapp.	String
`url`	The URL of the application. This property is not applicable for public apps, because public apps are specifically searched via the respective application API in the Android market (e.g., Google API) using its app identifier.	String
`name`	The name of the application. This field is mandatory when adding web apps (web clips), and optional when adding enterprise apps and public apps (store apps).	String
`schedule`	The date and time for the scheduled installation. This should follow the ISO 8601 format: `yyyy-MM-dd'T'HH:mm:ssZ` This field is not mandatory.	String
`deviceIDS`	ID of the Android device. Multiple device IDs can be added by using comma separated values. For more information on retrieving the device ID, see Retrieving the ID of an Android device.	String