Edits.images: upload

Requires authorization

Uploads a new image and adds it to the list of images for the specified language and image type.

This method supports an /upload URI and accepts uploaded media with the following characteristics:

  • Maximum file size: 15MB
  • Accepted Media MIME types: image/jpeg, image/png

Note: There is a maximum of eight screenshots per device.


HTTP request

POST https://www.googleapis.com/upload/androidpublisher/v2/applications/packageName/edits/editId/listings/language/imageType


Parameter name Value Description
Path parameters
editId string Unique identifier for this edit.
imageType string

Acceptable values are:
  • "featureGraphic"
  • "icon"
  • "phoneScreenshots"
  • "promoGraphic"
  • "sevenInchScreenshots"
  • "tenInchScreenshots"
  • "tvBanner"
  • "tvScreenshots"
  • "wearScreenshots"
language string The language code (a BCP-47 language tag) of the localized listing you want to add an image to. For example, to select Latin American Spanish, pass "es-419".
packageName string Unique identifier for the Android app that is being updated; for example, "com.spiffygame".
Required query parameters
uploadType string The type of upload request to the /upload URI. Acceptable values are:
  • media - Simple upload. Upload the media data.
  • resumable - Resumable upload. Upload the file in a resumable fashion, using a series of at least two requests.


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


Request body

Do not supply a request body with this method.


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

  "image": {
    "id": string,
    "url": string,
    "sha1": string
Property name Value Description Notes
image nested object
image.id string A unique id representing this image.
image.url string A URL that will serve a preview of the image.
image.sha1 string A sha1 hash of the image that was uploaded.