REST Resource: edits.listings

  • A Listing is a localized store listing resource for the ListingsService.

  • A Listing includes fields for language, title, full description, short description, and a video URL.

  • The Listings resource provides methods to delete, get, list, patch, and update localized store listings.

  • Possible error codes when using this resource include 5xx for generic server errors and 409 for concurrency update errors.

Resource: Listing

A localized store listing. The resource for ListingsService.

JSON representation 
{
  "language": string,
  "title": string,
  "fullDescription": string,
  "shortDescription": string,
  "video": string
}
Fields
language

string

Language localization code (a BCP-47 language tag; for example, "de-AT" for Austrian German).
title

string

Localized title of the app.
fullDescription

string

Full description of the app.
shortDescription

string

Short description of the app.
video

string

URL of a promotional YouTube video for the app.

Methods

delete

 Deletes a localized store listing.

deleteall

 Deletes all store listings.

get

 Gets a localized store listing.

list

 Lists all localized store listings.

patch

 Patches a localized store listing.

update

 Creates or updates a localized store listing.

Error codes

The operations of this resource, return the following HTTP error codes:

Error code Reason Description Resolution
400 invalidValue An invalid value was provided in the request. This is often returned for a malformed or invalid purchase token. Correct the invalid field value in the request body or parameters based on the API reference.
400 required A required field or parameter is missing from the request. Consult the API documentation to ensure all mandatory fields and parameters are included.
403 userInsufficientPermission The user does not have sufficient permission to perform the requested operation. Ensure the authenticated user has the necessary permissions in the Google Play Console. See Using a service account for more details.
404 notFound The requested resource could not be found. Verify the identifiers (e.g., purchase token, package name, product ID, subscription ID) are correct.
409 concurrentUpdate There was an attempt to update an object that is being updated concurrently. Retry the request with exponential backoff. Avoid simultaneous modifications to the same resource.
5xx Generic error Generic error in the Google Play server. Retry your request.

If the problem persists contact your Google Play account manager or submit a support request. Consider checking the Play Status Dashboard for any known outages.