跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
金融

gplay-reports-download

Financial and statistics report listing and downloading from Google Play Console via GCS. Use when asked to view, list, or download financial earnings, sales, payouts, or app statistics (installs, ratings, crashes).

tamtom · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add tamtom/gplay-cli-skills --skill gplay-reports-download

技能说明


name: gplay-reports-download description: Financial and statistics report listing and downloading from Google Play Console via GCS. Use when asked to view, list, or download financial earnings, sales, payouts, or app statistics (installs, ratings, crashes).

Google Play Reports Download

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.

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: varies by account — either pubsite_prod_rev_<id> or pubsite_prod_<id>. Always copy the exact URI from Play Console.
  • Financial reports: earnings/, sales/, payouts/, play_balance_krw/, wht_statements/ prefixes
  • Statistics reports: stats/installs/, stats/ratings/, stats/crashes/, stats/store_performance/, financial-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).

Prerequisites

  • A service account configured via gplay auth login
  • The GCS bucket ID (see below — this is not the same as the Play Console URL developer ID)
  • For financial reports: VIEW_FINANCIAL_DATA permission (service account must be added to Play Console with "View financial data" access)
  • For stats reports: VIEW_APP_INFORMATION permission (service account must be added to Play Console with "View app information" access)

Finding your bucket ID

Important: The bucket ID for reports is not the numeric ID in your Play Console URL. The URL ID and the GCS bucket ID are different.

To find the correct bucket ID:

  1. Go to Google Play Console > Download reports (in the left sidebar under "Download reports")
  2. Look for the Cloud Storage URI shown on that page, e.g.:
    gs://pubsite_prod_rev_12110000881713004121/
    
  3. You can pass either the full URI or just the numeric ID: 12110000881713004121

Alternatively, use the Google Cloud Console to find the bucket name associated with your Play Console account.

Common mistake: Using the developer ID from the Play Console URL (https://play.google.com/console/developers/<this_id>/...) will result in a 404 Not Found error because the GCS bucket uses a different internal ID.

Financial reports

List available financial reports

# List all financial reports
gplay reports financial list --bucket-id <id>

# You can also pass the full GCS URI
gplay reports financial list --bucket-id "gs://pubsite_prod_rev_12345/"

# Filter by type
gplay reports financial list --bucket-id <id> --type earnings
gplay reports financial list --bucket-id <id> --type sales
gplay reports financial list --bucket-id <id> --type payouts

# Filter by date range
gplay reports financial list --bucket-id <id> --from 2026-01 --to 2026-06

# Combine filters
gplay reports financial list --bucket-id <id> --type earnings --from 2026-01 --to 2026-03

Download financial reports

# Download earnings for a specific month
gplay reports financial download --bucket-id <id> --from 2026-01 --type earnings

# Download to a specific directory
gplay reports financial download --bucket-id <id> --from 2026-01 --type earnings --dir ./reports

# Download a range of months
gplay reports financial download --bucket-id <id> --from 2026-01 --to 2026-06 --type sales

Financial report types

TypeDescriptionFilename pattern
earningsRevenue and earnings dataearnings/earnings_YYYYMM_<id>.zip
salesSales transaction reportssales/salesreport_YYYYMM.zip
payoutsPayment disbursement reportspayouts/payout_YYYYMM.csv
play_balancePlay balance reports (KRW)play_balance_krw/...
wht_statementsWithholding tax statementswht_statements/...

Statistics reports

List available statistics reports

# List all stats reports
gplay reports stats list --bucket-id <id>

# Filter by package name
gplay reports stats list --bucket-id <id> --package com.example.app

# Filter by type
gplay reports stats list --bucket-id <id> --type installs

# Filter by date range and package
gplay reports stats list --bucket-id <id> --package com.example.app --type installs --from 2026-01 --to 2026-06

Download statistics reports

# Download installs report
gplay reports stats download --bucket-id <id> --package com.example.app --from 2026-01 --type installs

# Download to a specific directory
gplay reports stats download --bucket-id <id> --package com.example.app --from 2026-01 --type crashes --dir ./reports

# Download a range of months
gplay reports stats download --bucket-id <id> --package com.example.app --from 2026-01 --to 2026-06 --type ratings

Statistics report types

TypeDescriptionFilename pattern
installsInstall/uninstall datastats/installs/installs_<pkg>_YYYYMM_overview.csv
ratingsRating distributionstats/ratings/ratings_<pkg>_YYYYMM_overview.csv
crashesCrash occurrence datastats/crashes/crashes_<pkg>_YYYYMM_overview.csv
store_performanceStore listing performancestats/store_performance/...
subscriptionsSubscription metricsfinancial-stats/subscriptions/...

Flags reference

Financial commands

FlagRequiredDescription
--bucket-idYesGCS bucket ID or full URI
--typeNo (list: default all) / Yes (download)Report type: earnings, sales, payouts, play_balance, wht_statements, all
--fromNo (list) / Yes (download)Start month YYYY-MM
--toNoEnd month `YYY
阅读完整来源 ↗