@@ -23,25 +23,38 @@ forged ones.
2323
2424## Setup
2525
26- ### 1. Create a Google Cloud Service Account
26+ ### 1. Google Cloud Console Setup
2727
28281 . Go to [ Google Cloud Console] ( https://console.cloud.google.com/ )
29292 . Select your project (the one linked to your Google Play Console)
30- 3 . Navigate to ** IAM & Admin → Service Accounts**
31- 4 . Click ** Create Service Account**
30+ 3 . ** APIs & Services → Library** → search for ** "Google Play Android Developer API"** → ** Enable**
31+ 4 . Navigate to ** IAM & Admin → Service Accounts**
32+ 5 . Click ** Create Service Account**
3233 - Name: ` play-purchase-verifier `
33- - Role: ** Google Play Android Developer → View financial data** (or the broader "Financial Data" role)
34- 5 . After creation, click the service account → ** Keys** → ** Add Key → Create new key → JSON**
35- 6 . Download the JSON file — this is your service account key
34+ - Role: ** Basic → Viewer** (the real permissions are granted in Play Console, not here)
35+ 6 . After creation, click the service account → ** Keys** → ** Add Key → Create new key → JSON**
36+ 7 . Download the JSON file — this is your service account key
37+ 8 . Copy the service account email address (looks like ` play-purchase-verifier@your-project.iam.gserviceaccount.com ` )
3638
37- ### 2. Link Service Account to Google Play Console
39+ ### 2. Google Play Console — Grant Permissions
40+
41+ The "View financial data" permission does NOT exist in Google Cloud IAM — it is granted
42+ exclusively through the Google Play Console's user management:
3843
39441 . Go to [ Google Play Console] ( https://play.google.com/console/ )
40- 2 . Navigate to ** Settings → Developer account → Users & permissions**
45+ 2 . Navigate to ** Users and permissions** (left sidebar)
41463 . Click ** Invite new users**
42- 4 . Enter the service account's email address (from the JSON: ` client_email ` )
43- 5 . Under ** Account permissions** , grant ** View financial data** (or "Financial data" access)
44- 6 . Save
47+ 4 . Paste the service account's email address (from step 1.8)
48+ 5 . Under ** App permissions** → select your app → ** Apply**
49+ 6 . Under ** Account permissions** , tick these three checkboxes:
50+ - ✅ View app information and download bulk reports (read-only)
51+ - ✅ View financial data, orders, and cancellation survey responses
52+ - ✅ Manage orders and subscriptions
53+ 7 . Click ** Invite user**
54+
55+ > ⚠️ It can take up to 24 hours for Google to propagate new service-account
56+ > permissions to the Play Developer API. If you get 403 errors initially,
57+ > wait a few hours and retry.
4558
4659### 3. Configure Deno Deploy Secrets
4760
0 commit comments