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 Resolution
5xx 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.
409 Concurrency update error.

There was an attempt to update an object that is being updated. For example, a purchase is getting acknowledged by calling the Play Billing Library's acknowledgePurchase() method and by calling the Play Developer API's purchases.products.acknowledge at the same time.

 Retry your request.