Page Summary
-
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
5xxfor generic server errors and409for 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
|
Language localization code (a BCP-47 language tag; for example, "de-AT" for Austrian German). |
title
|
Localized title of the app. |
fullDescription
|
Full description of the app. |
shortDescription
|
Short description of the app. |
video
|
URL of a promotional YouTube video for the app. |
Methods |
|
|---|---|
|
Deletes a localized store listing. |
|
Deletes all store listings. |
|
Gets a localized store listing. |
|
Lists all localized store listings. |
|
Patches a localized store listing. |
|
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. |

