Edits.apks: addexternallyhosted

Requires authorization

Creates a new APK without uploading the APK itself to Google Play, instead hosting the APK at a specified URL. This function is only available to enterprises using Google Play for Work whose application is configured to restrict distribution to the enterprise domain.

Request

HTTP request

POST https://www.googleapis.com/androidpublisher/v2/applications/packageName/edits/editId/apks/externallyHosted

Parameters

Parameter name	Value	Description
Path parameters
`editId`	`string`	Unique identifier for this edit.
`packageName`	`string`	Unique identifier for the Android app that is being updated; for example, "com.spiffygame".

Authorization

This request requires authorization with the following scope (read more about authentication and authorization).

Scope
`https://www.googleapis.com/auth/androidpublisher`

Request body

In the request body, supply data with the following structure:

{
  "externallyHostedApk": {
    "packageName": string,
    "applicationLabel": string,
    "versionCode": integer,
    "versionName": string,
    "fileSize": long,
    "fileSha1Base64": string,
    "fileSha256Base64": string,
    "iconBase64": string,
    "minimumSdk": integer,
    "certificateBase64s": [
      string
    ],
    "externallyHostedUrl": string,
    "maximumSdk": integer,
    "nativeCodes": [
      string
    ],
    "usesFeatures": [
      string
    ],
    "usesPermissions": [
      {
        "name": string,
        "maxSdkVersion": integer
      }
    ]
  }
}

Property name	Value	Description
`externallyHostedApk`	`nested object`	The definition of the externally-hosted APK and where it is located.
`externallyHostedApk.packageName`	`string`	The package name.
`externallyHostedApk.applicationLabel`	`string`	The application label.
`externallyHostedApk.versionCode`	`integer`	The version code of this APK.
`externallyHostedApk.versionName`	`string`	The version name of this APK.
`externallyHostedApk.fileSize`	`long`	The file size in bytes of this APK.
`externallyHostedApk.fileSha1Base64`	`string`	The SHA1 checksum of this APK, represented as a base64 encoded byte array.
`externallyHostedApk.fileSha256Base64`	`string`	The SHA256 checksum of this APK, represented as a base64 encoded byte array.
`externallyHostedApk.iconBase64`	`string`	The icon image from the APK, as a base64 encoded byte array.
`externallyHostedApk.minimumSdk`	`integer`	The minimum SDK targeted by this APK.
`externallyHostedApk.certificateBase64s[]`	`list`	A certificate (or array of certificates if a certificate-chain is used) used to signed this APK, represented as a base64 encoded byte array.
`externallyHostedApk.externallyHostedUrl`	`string`	The URL at which the APK is hosted. This must be an https URL.
`externallyHostedApk.maximumSdk`	`integer`	The maximum SDK supported by this APK (optional).
`externallyHostedApk.nativeCodes[]`	`list`	The native code environments supported by this APK (optional).
`externallyHostedApk.usesFeatures[]`	`list`	The features required by this APK (optional).
`externallyHostedApk.usesPermissions[]`	`list`	The permissions requested by this APK.
`externallyHostedApk.usesPermissions[].name`	`string`	The name of the permission requested.
`externallyHostedApk.usesPermissions[].maxSdkVersion`	`integer`	Optionally, the maximum SDK version for which the permission is required.

Response

If successful, this method returns a response body with the following structure:

{
  "externallyHostedApk": {
    "packageName": string,
    "applicationLabel": string,
    "versionCode": integer,
    "versionName": string,
    "fileSize": long,
    "fileSha1Base64": string,
    "fileSha256Base64": string,
    "iconBase64": string,
    "minimumSdk": integer,
    "certificateBase64s": [
      string
    ],
    "externallyHostedUrl": string,
    "maximumSdk": integer,
    "nativeCodes": [
      string
    ],
    "usesFeatures": [
      string
    ],
    "usesPermissions": [
      {
        "name": string,
        "maxSdkVersion": integer
      }
    ]
  }
}

Property name	Value	Description
`externallyHostedApk`	`nested object`	The definition of the externally-hosted APK and where it is located.
`externallyHostedApk.packageName`	`string`	The package name.
`externallyHostedApk.applicationLabel`	`string`	The application label.
`externallyHostedApk.versionCode`	`integer`	The version code of this APK.
`externallyHostedApk.versionName`	`string`	The version name of this APK.
`externallyHostedApk.fileSize`	`long`	The file size in bytes of this APK.
`externallyHostedApk.fileSha1Base64`	`string`	The SHA1 checksum of this APK, represented as a base64 encoded byte array.
`externallyHostedApk.fileSha256Base64`	`string`	The SHA256 checksum of this APK, represented as a base64 encoded byte array.
`externallyHostedApk.iconBase64`	`string`	The icon image from the APK, as a base64 encoded byte array.
`externallyHostedApk.minimumSdk`	`integer`	The minimum SDK targeted by this APK.
`externallyHostedApk.certificateBase64s[]`	`list`	A certificate (or array of certificates if a certificate-chain is used) used to signed this APK, represented as a base64 encoded byte array.
`externallyHostedApk.externallyHostedUrl`	`string`	The URL at which the APK is hosted. This must be an https URL.
`externallyHostedApk.maximumSdk`	`integer`	The maximum SDK supported by this APK (optional).
`externallyHostedApk.nativeCodes[]`	`list`	The native code environments supported by this APK (optional).
`externallyHostedApk.usesFeatures[]`	`list`	The features required by this APK (optional).
`externallyHostedApk.usesPermissions[]`	`list`	The permissions requested by this APK.
`externallyHostedApk.usesPermissions[].name`	`string`	The name of the permission requested.
`externallyHostedApk.usesPermissions[].maxSdkVersion`	`integer`	Optionally, the maximum SDK version for which the permission is required.