gplay-reports-download

List and download Google Play Console financial and statistics reports from GCS buckets.

Updated Mar 25, 2026
One-click install
npx skills add https://github.com/lettucebo/Skills --skill gplay-reports-download-lettucebo
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gplay-reports-download
Source: https://github.com/lettucebo/Skills/tree/main/skills/google-play-console-cli/gplay-reports-download
Command: npx skills add https://github.com/lettucebo/Skills --skill gplay-reports-download-lettucebo

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Google Play Console reports are not available via the REST API; they live as CSV/ZIP files in Google Cloud Storage buckets, making manual retrieval tedious and error-prone. This Skill automates listing and downloading financial reports (earnings, sales, payouts) and statistics reports (installs, ratings, crashes) directly from those GCS buckets. ## Core Features & Use Cases - Financial Report Access: List and download earnings, sales, payouts, play balance, and withholding tax statement reports filtered by type and month range. - Statistics Report Access: Retrieve installs, ratings, crashes, store performance, and subscription metrics filtered by package name and date range. - Structured Output: Get results as JSON, table, or Markdown for scripting, CI/CD archival, or analysis pipelines. - Use Case: Automate a monthly finance review by downloading all earnings and sales reports for the quarter into a local directory, or pull crash statistics for an app to feed into a quality dashboard. ## Quick Start Ask the AI to list all earnings reports from your Play Console bucket for the last quarter and download them into a local reports folder.

Frequently Asked Questions about gplay-reports-download

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download Google Play Console financial reports from the command line?▼

Use gplay reports financial download with your GCS bucket ID, a report type such as earnings or sales, and a start month in YYYY-MM format. Reports are stored as CSV or ZIP files in the bucket and saved to your chosen output directory.

How to list app install and crash statistics from Google Play?▼

Run gplay reports stats list with your bucket ID, package name, and a type filter such as installs, ratings, or crashes. You can narrow results with --from and --to month ranges and output as JSON, table, or Markdown.

Why does Google Play report download return 404 Not Found?▼

A 404 usually means the wrong bucket ID was used. The numeric developer ID in the Play Console URL differs from the GCS bucket ID; copy the exact Cloud Storage URI from Play Console under Download reports instead.

What permissions are needed to access Google Play financial reports?▼

The service account must be added to Play Console with View financial data permission for financial reports, or View app information for statistics reports. Access to the underlying GCS bucket is granted automatically once these permissions are set.

Can I access Google Play reports through the REST API?▼

No, Google Play Console reports are not available via the REST API. They are stored as CSV and ZIP files in Google Cloud Storage buckets with prefixes like earnings/, sales/, and stats/installs/, which this tool reads directly.