Back to Details

gplay-reports-download

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Google Play Reports Download

Google Play 报告下载

Use this skill when you need to list or download financial reports (earnings, sales, payouts) or statistics reports (installs, ratings, crashes, store performance, subscriptions) from Google Play Console.
当你需要从Google Play Console列出或下载财务报告（收益、销售、付款）或统计报告（安装量、评分、崩溃数据、商店表现、订阅）时，使用此技能。

How reports work

报告工作机制

Google Play Console reports are not available via the REST API. They are stored as CSV/ZIP files in Google Cloud Storage (GCS) buckets:
  • Bucket name: 
    pubsite_prod_rev_<developer_id>
  • Financial reports: 
    earnings/
    , 
    sales/
    , 
    payouts/
    prefixes
  • Statistics reports: 
    stats/installs/
    , 
    stats/ratings/
    , 
    stats/crashes/
    , 
    stats/store_performance/
    , 
    stats/subscriptions/
    prefixes
The service account must have access to the GCS bucket (this access is granted automatically when the service account is added to Play Console with appropriate permissions).
Google Play Console报告无法通过REST API获取，它们以CSV/ZIP文件的形式存储在Google Cloud Storage (GCS)存储桶中：
  • 存储桶名称：
    pubsite_prod_rev_<developer_id>
  • 财务报告：
    earnings/
    、
    sales/
    、
    payouts/
    前缀
  • 统计报告：
    stats/installs/
    、
    stats/ratings/
    、
    stats/crashes/
    、
    stats/store_performance/
    、
    stats/subscriptions/
    前缀
服务账号必须拥有GCS存储桶的访问权限（当服务账号被添加到Play Console并分配适当权限时，该访问权限会自动授予）。

Prerequisites

前置条件

  • A service account configured via 
    gplay auth login
  • The developer ID (found in Play Console URL or settings)
  • For financial reports: 
    VIEW_FINANCIAL_DATA
    permission
  • For stats reports: 
    VIEW_APP_INFORMATION
    permission
  • 已通过
    gplay auth login
    配置服务账号
  • 开发者ID（可在Play Console网址或设置中找到）
  • 财务报告：需
    VIEW_FINANCIAL_DATA
    权限
  • 统计报告：需
    VIEW_APP_INFORMATION
    权限

Finding your developer ID

查找开发者ID

The developer ID is the numeric ID in your Play Console URL:
https://play.google.com/console/developers/<developer_id>/...
开发者ID是Play Console网址中的数字ID：
https://play.google.com/console/developers/<developer_id>/...

Financial reports

财务报告

List available financial reports

列出可用的财务报告

bash
undefined
bash
undefined

List all financial reports

List all financial reports

gplay reports financial list --developer <id>
gplay reports financial list --developer <id>

Filter by type

Filter by type

gplay reports financial list --developer <id> --type earnings gplay reports financial list --developer <id> --type sales gplay reports financial list --developer <id> --type payouts
gplay reports financial list --developer <id> --type earnings gplay reports financial list --developer <id> --type sales gplay reports financial list --developer <id> --type payouts

Filter by date range

Filter by date range

gplay reports financial list --developer <id> --from 2026-01 --to 2026-06
gplay reports financial list --developer <id> --from 2026-01 --to 2026-06

Combine filters

Combine filters

gplay reports financial list --developer <id> --type earnings --from 2026-01 --to 2026-03
undefined
gplay reports financial list --developer <id> --type earnings --from 2026-01 --to 2026-03
undefined

Download financial reports

下载财务报告

bash
undefined
bash
undefined

Download earnings for a specific month

Download earnings for a specific month

gplay reports financial download --developer <id> --from 2026-01 --type earnings
gplay reports financial download --developer <id> --from 2026-01 --type earnings

Download to a specific directory

Download to a specific directory

gplay reports financial download --developer <id> --from 2026-01 --type earnings --dir ./reports
gplay reports financial download --developer <id> --from 2026-01 --type earnings --dir ./reports

Download a range of months

Download a range of months

gplay reports financial download --developer <id> --from 2026-01 --to 2026-06 --type sales
undefined
gplay reports financial download --developer <id> --from 2026-01 --to 2026-06 --type sales
undefined

Financial report types

财务报告类型

TypeDescriptionFilename pattern
earnings
Revenue and earnings data
earnings/earnings_YYYYMM_<id>.zip
sales
Sales transaction reports
sales/salesreport_YYYYMM.zip
payouts
Payment disbursement reports
payouts/payout_YYYYMM.csv
类型描述文件名格式
earnings
收入与收益数据
earnings/earnings_YYYYMM_<id>.zip
sales
销售交易报告
sales/salesreport_YYYYMM.zip
payouts
付款发放报告
payouts/payout_YYYYMM.csv

Statistics reports

统计报告

List available statistics reports

列出可用的统计报告

bash
undefined
bash
undefined

List all stats reports for a developer

List all stats reports for a developer

gplay reports stats list --developer <id>
gplay reports stats list --developer <id>

Filter by package name

Filter by package name

gplay reports stats list --developer <id> --package com.example.app
gplay reports stats list --developer <id> --package com.example.app

Filter by type

Filter by type

gplay reports stats list --developer <id> --type installs
gplay reports stats list --developer <id> --type installs

Filter by date range and package

Filter by date range and package

gplay reports stats list --developer <id> --package com.example.app --type installs --from 2026-01 --to 2026-06
undefined
gplay reports stats list --developer <id> --package com.example.app --type installs --from 2026-01 --to 2026-06
undefined

Download statistics reports

下载统计报告

bash
undefined
bash
undefined

Download installs report

Download installs report

gplay reports stats download --developer <id> --package com.example.app --from 2026-01 --type installs
gplay reports stats download --developer <id> --package com.example.app --from 2026-01 --type installs

Download to a specific directory

Download to a specific directory

gplay reports stats download --developer <id> --package com.example.app --from 2026-01 --type crashes --dir ./reports
gplay reports stats download --developer <id> --package com.example.app --from 2026-01 --type crashes --dir ./reports

Download a range of months

Download a range of months

gplay reports stats download --developer <id> --package com.example.app --from 2026-01 --to 2026-06 --type ratings
undefined
gplay reports stats download --developer <id> --package com.example.app --from 2026-01 --to 2026-06 --type ratings
undefined

Statistics report types

统计报告类型

TypeDescriptionFilename pattern
installs
Install/uninstall data
stats/installs/installs_<pkg>_YYYYMM_overview.csv
ratings
Rating distribution
stats/ratings/ratings_<pkg>_YYYYMM_overview.csv
crashes
Crash occurrence data
stats/crashes/crashes_<pkg>_YYYYMM_overview.csv
store_performance
Store listing performance
stats/store_performance/...
subscriptions
Subscription metrics
stats/subscriptions/...
类型描述文件名格式
installs
安装/卸载数据
stats/installs/installs_<pkg>_YYYYMM_overview.csv
ratings
评分分布
stats/ratings/ratings_<pkg>_YYYYMM_overview.csv
crashes
崩溃发生数据
stats/crashes/crashes_<pkg>_YYYYMM_overview.csv
store_performance
商店列表表现
stats/store_performance/...
subscriptions
订阅指标
stats/subscriptions/...

Flags reference

参数参考

Financial commands

财务命令参数

FlagRequiredDescription
--developer
YesDeveloper ID
--type
No (list: default 
all
) / Yes (download)		Report type: 
earnings
, 
sales
, 
payouts
, 
all
--from
No (list) / Yes (download)Start month 
YYYY-MM
--to
NoEnd month 
YYYY-MM
(defaults to 
--from
)
--dir
NoOutput directory (default 
.
)
--output
NoOutput format: 
json
, 
table
, 
markdown
--pretty
NoPretty-print JSON output
参数是否必填描述
--developer
是开发者ID
--type
否（列表命令默认
all
）/ 是（下载命令）		报告类型：
earnings
、
sales
、
payouts
、
all
--from
否（列表命令）/ 是（下载命令）起始月份 
YYYY-MM
--to
否结束月份 
YYYY-MM
（默认与
--from
相同）
--dir
否输出目录（默认
.
）
--output
否输出格式：
json
、
table
、
markdown
--pretty
否格式化输出JSON

Stats commands

统计命令参数

FlagRequiredDescription
--developer
YesDeveloper ID
--package
No (list) / Yes (download)Package name filter
--type
No (list: default 
all
) / Yes (download)		Stats type: 
installs
, 
ratings
, 
crashes
, 
store_performance
, 
subscriptions
, 
all
--from
No (list) / Yes (download)Start month 
YYYY-MM
--to
NoEnd month 
YYYY-MM
(defaults to 
--from
)
--dir
NoOutput directory (default 
.
)
--output
NoOutput format: 
json
, 
table
, 
markdown
--pretty
NoPretty-print JSON output
参数是否必填描述
--developer
是开发者ID
--package
否（列表命令）/ 是（下载命令）包名筛选
--type
否（列表命令默认
all
）/ 是（下载命令）		统计类型：
installs
、
ratings
、
crashes
、
store_performance
、
subscriptions
、
all
--from
否（列表命令）/ 是（下载命令）起始月份 
YYYY-MM
--to
否结束月份 
YYYY-MM
（默认与
--from
相同）
--dir
否输出目录（默认
.
）
--output
否输出格式：
json
、
table
、
markdown
--pretty
否格式化输出JSON

Output format

输出格式

List output

列表输出

json
{
  "developer": "12345",
  "bucket": "pubsite_prod_rev_12345",
  "reports": [
    {"name": "earnings/earnings_202601_12345.zip", "size": 1234, "updated": "2026-02-01T00:00:00Z"}
  ]
}
json
{
  "developer": "12345",
  "bucket": "pubsite_prod_rev_12345",
  "reports": [
    {"name": "earnings/earnings_202601_12345.zip", "size": 1234, "updated": "2026-02-01T00:00:00Z"}
  ]
}

Download output

下载输出

json
{
  "developer": "12345",
  "type": "earnings",
  "from": "2026-01",
  "to": "2026-01",
  "dir": "./reports",
  "files": [
    {"name": "earnings/earnings_202601_12345.zip", "path": "reports/earnings_202601_12345.zip", "size": 1234}
  ]
}
json
{
  "developer": "12345",
  "type": "earnings",
  "from": "2026-01",
  "to": "2026-01",
  "dir": "./reports",
  "files": [
    {"name": "earnings/earnings_202601_12345.zip", "path": "reports/earnings_202601_12345.zip", "size": 1234}
  ]
}

Common workflows

常见工作流

Monthly financial review

月度财务审核

bash
undefined
bash
undefined

List last month's earnings

List last month's earnings

gplay reports financial list --developer <id> --type earnings --from 2026-01 --output table
gplay reports financial list --developer <id> --type earnings --from 2026-01 --output table

Download all financial reports for Q1

Download all financial reports for Q1

gplay reports financial download --developer <id> --from 2026-01 --to 2026-03 --type earnings --dir ./q1-reports
undefined
gplay reports financial download --developer <id> --from 2026-01 --to 2026-03 --type earnings --dir ./q1-reports
undefined

App performance monitoring

应用性能监控

bash
undefined
bash
undefined

Check install trends

Check install trends

gplay reports stats list --developer <id> --package com.example.app --type installs --from 2026-01
gplay reports stats list --developer <id> --package com.example.app --type installs --from 2026-01

Download crash data for analysis

Download crash data for analysis

gplay reports stats download --developer <id> --package com.example.app --from 2026-01 --type crashes --dir ./crash-data
undefined
gplay reports stats download --developer <id> --package com.example.app --from 2026-01 --type crashes --dir ./crash-data
undefined

CI/CD automated report collection

CI/CD自动化报告收集

bash
undefined
bash
undefined

Download all report types for archival

Download all report types for archival

for type in earnings sales payouts; do gplay reports financial download --developer $DEV_ID --from $(date -d "last month" +%Y-%m) --type $type --dir ./monthly-reports done
undefined
for type in earnings sales payouts; do gplay reports financial download --developer $DEV_ID --from $(date -d "last month" +%Y-%m) --type $type --dir ./monthly-reports done
undefined

Troubleshooting

故障排除

ErrorCauseFix
authentication failed
Service account not configuredRun 
gplay auth login --service-account <path>
403 Forbidden
No GCS bucket accessEnsure service account is invited in Play Console with appropriate permissions
404 Not Found
Wrong developer ID or no reportsVerify developer ID from Play Console URL
Empty reports listNo reports for the date rangeCheck 
--from
/
--to
range; reports may not exist for all months
错误原因解决方法
authentication failed
未配置服务账号运行 
gplay auth login --service-account <path>
403 Forbidden
无GCS存储桶访问权限确保服务账号已被邀请至Play Console并分配了相应权限
404 Not Found
开发者ID错误或无报告从Play Console网址验证开发者ID
报告列表为空该日期范围内无报告检查
--from
/
--to
范围；并非所有月份都有报告