REST Resource: grants

  • A Grant is an access grant resource represented by a JSON object with fields for name, packageName, and appLevelPermissions.

  • AppLevelPermission defines specific permissions granted at a per-app level, such as managing store presence or viewing financial data.

  • The resource supports methods for creating, deleting, and patching grants to manage user access to packages.

  • Error codes like 5xx and 409 provide information on server errors and concurrency update issues respectively, along with suggested resolutions.

Resource: Grant

An access grant resource.

JSON representation 
{
  "name": string,
  "packageName": string,
  "appLevelPermissions": [
    enum (AppLevelPermission)
  ]
}
Fields
name

string

Required. Resource name for this grant, following the pattern "developers/{developer}/users/{email}/grants/{packageName}". If this grant is for a draft app, the app ID will be used in this resource name instead of the package name.
packageName

string

Immutable. The package name of the app. This will be empty for draft apps.
appLevelPermissions[]

enum (AppLevelPermission)

The permissions granted to the user for this app.

AppLevelPermission

A permission granted at a per-app level.

Enums
APP_LEVEL_PERMISSION_UNSPECIFIED Unknown or unspecified permission.
CAN_ACCESS_APP

View app information (read-only). Deprecated: Try defining a more granular capability. Otherwise, check AppLevelPermission.CAN_VIEW_NON_FINANCIAL_DATA.
CAN_VIEW_FINANCIAL_DATA View financial data.
CAN_MANAGE_PERMISSIONS Admin (all permissions).
CAN_REPLY_TO_REVIEWS reviews.reply to reviews.
CAN_MANAGE_PUBLIC_APKS Release to production, exclude devices, and use app signing by Google Play.
CAN_MANAGE_TRACK_APKS Release to testing tracks.
CAN_MANAGE_TRACK_USERS Manage testing tracks and edit tester lists.
CAN_MANAGE_PUBLIC_LISTING Manage store presence.
CAN_MANAGE_DRAFT_APPS Edit and delete draft apps.
CAN_MANAGE_ORDERS Manage orders and subscriptions.
CAN_MANAGE_APP_CONTENT Manage policy related pages.
CAN_VIEW_NON_FINANCIAL_DATA View app information (read-only).
CAN_VIEW_APP_QUALITY View app quality data such as Vitals, Crashes etc.

Methods

create

 Grant access for a user to the given package.

delete

 Removes all access for the user to the given package or developer account.

patch

 Updates access for the user to the given package.

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.