用途:该技能用于列出或下载 Google Play Console 的财务报告与统计报告。这些报告不走 REST API,而是以 CSV/ZIP 文件存放在 Google Cloud Storage(GCS)桶中,桶名形如 pubsite_prod_rev_<id> 或 pubsite_prod_<id>,需从 Play Console「Download reports」页复制 Cloud Storage URI,而非使用控制台 URL 中的开发者 ID,否则会返回 404。
前提条件:先通过 gplay auth login 配置服务账号;财务报告需 VIEW_FINANCIAL_DATA 权限,统计报告需 VIEW_APP_INFORMATION 权限。
主要能力与用法:财务报告前缀包括 earnings、sales、payouts、play_balance_krw、wht_statements;统计报告前缀包括 stats/installs、stats/ratings、stats/crashes、stats/store_performance、financial-stats/subscriptions。列出用 gplay reports financial list --bucket-id <id> 或 gplay reports stats list --bucket-id <id>,可按 --type、--from、--to、--package 过滤。下载用 gplay reports financial download --bucket-id <id> --from 2026-01 --type earnings 或 gplay reports stats download --bucket-id <id> --package com.example.app --from 2026-01 --type installs,支持 --dir 指定输出目录、--output json/table/markdown、--pretty。
适用场景:月度财务核对、下载季度收入/销售报告、监控安装与崩溃趋势、CI/CD 中批量归档报告。
限制:--bucket-id 必填且须为正确的 GCS 桶 ID;下载时 --type 与 --from 必填,--to 默认等于 --from;认证失败需重跑 gplay auth login --service-account <path>,403 表示服务账号无桶访问权限,空列表可能因该日期范围无报告。价格、收费标准等资料暂未提供。