> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.qonversion.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Play Service Account Key

> Google Play Service Account Key

You need to provide the Play Store service account key to [your Qonversion project settings](https://dash.qonversion.io/project/stores) so that we can verify your in-app purchases. Qonversion provides out-of-the-box in-app subscription infrastructure. Learn more about [Qonversion](https://qonversion.io) and [sign up](https://dash.qonversion.io/site/signup?utm_source=docs\&utm_medium=docs\&utm_campaign=servicekey) for free.

Service accounts provide access to the Google Play Developer Publishing API on behalf of an application rather than an end user. Service accounts are suitable for accessing the API from an unattended server, such as an automated build server (e.g. Jenkins). All actions will be shown as originating from the service account. You can edit permissions for the service account on the ‘User Accounts & Rights’ page.

## 1. Enable Google APIs in the Google Cloud Console

1. Go to the [Google Cloud Console](https://console.cloud.google.com/welcome).

2. Select your project from the projects list or create a new one.

3. Go to the [API & Services tab](https://console.cloud.google.com/apis/dashboard) and click the "Enable API and Services" button. <img src="https://mintcdn.com/qonversion/cVFu44J4hjAFIf6D/images/docs/3fa23fb-API-Services.png?fit=max&auto=format&n=cVFu44J4hjAFIf6D&q=85&s=1aeded37e99946cef2d162fcece1f91f" alt="" width="3428" height="1842" data-path="images/docs/3fa23fb-API-Services.png" />

4. In the [API Library tab](https://console.cloud.google.com/apis/library), search for the [Google Play Developer Reporting API](https://console.cloud.google.com/apis/library/playdeveloperreporting.googleapis.com). <img src="https://mintcdn.com/qonversion/cVFu44J4hjAFIf6D/images/docs/47c274f-API_Library.png?fit=max&auto=format&n=cVFu44J4hjAFIf6D&q=85&s=ecf7eb191f6856b5ca8593f1f6d822f4" alt="" width="3452" height="1420" data-path="images/docs/47c274f-API_Library.png" />

5. Enable the API for your project. <img src="https://mintcdn.com/qonversion/5ayPzXwd3DQ-zcvl/images/docs/58fcdfb-Google_Play_Developer_Reporting_API.png?fit=max&auto=format&n=5ayPzXwd3DQ-zcvl&q=85&s=ab8ccf5bc00dd3bb4a85113dc3ccb1e1" alt="" width="3432" height="1849" data-path="images/docs/58fcdfb-Google_Play_Developer_Reporting_API.png" />

6. Enable [Google Play Android Developer API](https://console.cloud.google.com/apis/library/androidpublisher.googleapis.com).

   <img src="https://mintcdn.com/qonversion/i4lAeIKmC47lf8K-/images/docs/05afe8d4f2bf103c01c9bf85a3d81e2d3d0d4889f75ccc2eab679aa444237289-enable-googledeveloper-api.png?fit=max&auto=format&n=i4lAeIKmC47lf8K-&q=85&s=1a9a774cb74e91f6527fdae889c9b1bf" alt="" width="1608" height="1006" data-path="images/docs/05afe8d4f2bf103c01c9bf85a3d81e2d3d0d4889f75ccc2eab679aa444237289-enable-googledeveloper-api.png" />

7. Enable [Cloud Pub/Sub API](https://console.cloud.google.com/apis/library/pubsub.googleapis.com).

   <img src="https://mintcdn.com/qonversion/eOsiYIQAgYr1cnnF/images/docs/7e55613831234022eb6d65eaf8257d3628fd689695110011b8fa9e4325337d87-enable-subs.png?fit=max&auto=format&n=eOsiYIQAgYr1cnnF&q=85&s=8841dc4e19480d17df4d48103c307276" alt="" width="1298" height="1098" data-path="images/docs/7e55613831234022eb6d65eaf8257d3628fd689695110011b8fa9e4325337d87-enable-subs.png" />

## 2. Create a Service account in the Google Cloud Console

1. Go to the [Google Cloud Console](https://console.cloud.google.com/welcome) ➡ [IAM & Admin](https://console.cloud.google.com/iam-admin/iam) ➡ [Service Accounts](https://console.cloud.google.com/iam-admin/serviceaccounts).
   1. Add a role **Release manager** to it.

2. Click **Create Service Account**. <img src="https://mintcdn.com/qonversion/5ayPzXwd3DQ-zcvl/images/docs/5e63280-Service_Accounts.png?fit=max&auto=format&n=5ayPzXwd3DQ-zcvl&q=85&s=de9e4d079f35f73de80dcdbe51162052" alt="" width="3448" height="1868" data-path="images/docs/5e63280-Service_Accounts.png" />

3. Enter your service account name, copy its **ID**, and click **Create and Continue**. <img src="https://mintcdn.com/qonversion/cVFu44J4hjAFIf6D/images/docs/251a4e1-Create_service_account.png?fit=max&auto=format&n=cVFu44J4hjAFIf6D&q=85&s=344faecf8a77d4cccb8af98d7c31c05a" alt="" width="2766" height="1866" data-path="images/docs/251a4e1-Create_service_account.png" />

4. Grant this service account access to the project by enabling:

   * **Pub/Sub Admin** (to enable [Google Developer Notifications](google-developer-notifications)) <img src="https://mintcdn.com/qonversion/i4lAeIKmC47lf8K-/images/docs/11ebf5e-PubSub_Admin.png?fit=max&auto=format&n=i4lAeIKmC47lf8K-&q=85&s=8503b3ecc990e653671194a882fb8f22" alt="" width="2764" height="1856" data-path="images/docs/11ebf5e-PubSub_Admin.png" />
   * **Monitoring Viewer** (to allow monitoring of the notification queue) <img src="https://mintcdn.com/qonversion/5c527iOH0vIMjiW3/images/docs/be10833-Monitoring_viewer.png?fit=max&auto=format&n=5c527iOH0vIMjiW3&q=85&s=788ae879a0ebd04352a56898aa35f9b7" alt="" width="2768" height="1954" data-path="images/docs/be10833-Monitoring_viewer.png" />

5. Skip the last step and click **Done**. <img src="https://mintcdn.com/qonversion/yQ3ibfsM1_xLwGXK/images/docs/e5bf7bf-Service_account_done.png?fit=max&auto=format&n=yQ3ibfsM1_xLwGXK&q=85&s=32a5adebf5f2b546a4c8e205ff784d99" alt="" width="2762" height="1766" data-path="images/docs/e5bf7bf-Service_account_done.png" />

## 3. Create and download the service key

1. Go to the **Service Accounts** section in the Google Cloud Console, choose your recently created key, click on the three dots to open the Actions dropdown menu, and then choose **Manage Keys**. <img src="https://mintcdn.com/qonversion/5ayPzXwd3DQ-zcvl/images/docs/5818e6f-Manage_Keys.png?fit=max&auto=format&n=5ayPzXwd3DQ-zcvl&q=85&s=82b8c17bb8666252d1c75f084268737c" alt="" width="3454" height="1623" data-path="images/docs/5818e6f-Manage_Keys.png" />
2. Click the **Add Key** button, then click **Create new key**. <img src="https://mintcdn.com/qonversion/NxsDOZgG-HJmkYhN/images/docs/a7a9fea-Create_new_key.png?fit=max&auto=format&n=NxsDOZgG-HJmkYhN&q=85&s=2c71a0faf44164ccc75d10552a3b15aa" alt="" width="3452" height="1620" data-path="images/docs/a7a9fea-Create_new_key.png" />
3. In the pop-up window, ensure that JSON is chosen and click **Create** to generate and download the JSON Key on your computer. <img src="https://mintcdn.com/qonversion/eOsiYIQAgYr1cnnF/images/docs/81bec83-Create_JSON.png?fit=max&auto=format&n=eOsiYIQAgYr1cnnF&q=85&s=7e0820b52b14004cc6ef7756525415b3" alt="" width="2162" height="1602" data-path="images/docs/81bec83-Create_JSON.png" />

## 4. Grant Access to Qonversion

1. Navigate to the **Users and Permissions** section in the Google Play Console and click **Invite new users**. <img src="https://mintcdn.com/qonversion/NxsDOZgG-HJmkYhN/images/docs/a9c1c05-Invite_new_users.png?fit=max&auto=format&n=NxsDOZgG-HJmkYhN&q=85&s=78679bb2575bff665dc39df664eeb8c7" alt="" width="3434" height="1112" data-path="images/docs/a9c1c05-Invite_new_users.png" />

2. Enter the email of the service account that you created before, add your application, and click **Apply**. <img src="https://mintcdn.com/qonversion/eOsiYIQAgYr1cnnF/images/docs/9407c56-Invite-App.png?fit=max&auto=format&n=eOsiYIQAgYr1cnnF&q=85&s=2b45b39d0ada96b0dbe91e04348f7014" alt="" width="2138" height="1608" data-path="images/docs/9407c56-Invite-App.png" />

3. Grant the following account permissions and click **Invite user** at the bottom of the page. Afterwards, you will be directed to the **Users and Permissions** section, where you should observe your recently established account listed as active.

   * View app information and download bulk reports (read-only)
   * View financial data, orders, and cancellation survey response
   * Manage orders and subscriptions <img src="https://mintcdn.com/qonversion/cVFu44J4hjAFIf6D/images/docs/2532d5f-Account_permissions.png?fit=max&auto=format&n=cVFu44J4hjAFIf6D&q=85&s=4043d66f53b4fc758bb5abc0c64057d1" alt="" width="3438" height="1982" data-path="images/docs/2532d5f-Account_permissions.png" /> You have the flexibility to choose whether to check or uncheck the remaining boxes based on your specific requirements as long as the aforementioned three boxes are checked.

## 5. Paste the credentials JSON to the Qonversion project settings

Paste the content of the credentials JSON file you downloaded in step 3 to your Qonversion project settings.

<img src="https://mintcdn.com/qonversion/5c527iOH0vIMjiW3/images/docs/e21a6bd-Google_API_Key.png?fit=max&auto=format&n=5c527iOH0vIMjiW3&q=85&s=aa8f87e8dfce33530d23b6e861e503dc" alt="" width="1958" height="1900" data-path="images/docs/e21a6bd-Google_API_Key.png" />

<Info>
  It takes up to 24 hours for your Google service credentials to work properly with the Android Developer API. You may see "Please provide valid JSON credentials" during the first 24 hours until the credentials start working properly.
</Info>

<Info>
  If [in-app products](android-in-app-products) are created before granting users access or linking Google Cloud Project to the service account, it can cause problems with the receipt validation using Google Play Android Developer API. Google Play Developer API can return the following error *"The current user has insufficient permissions to perform the requested operation."*

  When facing this problem, open the In-app products or Subscription tab on the Google Play Console and make some updates. For example, you can edit the product description and save it.
</Info>

***

[App Store Connect Shared Secret](ios-app-store-info-fields#2-generate-the-app-specific-shared-secret)

[\[Jan 2026\] Migration guide. Cordova 7.](jan-2026-migration-guide-cordova-7)
