Androidアプリ開発者向けのGoogle Play Console売上集計・精算ツールです。月ごとの売上、手数料、返金、税金、手取り額を自動で計算しExcelに出力します。
はい。データ処理はセッション内で安全に行われ、外部に保存・共有されることはありません。
Google Play Consoleからダウンロードした標準の売上ZIPアーカイブに対応しています。
はい、月別の詳細がまとめられたきれいなExcelシートをダウンロードできます。
Googleからの収益が入り始めると、すぐに「なぜ管理画面の金額と銀行の入金額が合わないのか」という疑問が出てきます。収益が確定して支払われる仕組みを理解すれば、毎月の照合がずっと楽になります。
AdSenseの管理画面にリアルタイムで表示される金額は見積もり収益です。月が終わると、Googleは無効なトラフィックを除外して数値を確認し、確定収益が通常翌月の初めに残高へ加算されます。そのため見積もり額と確定額は少し異なることがあります。
10月1日〜31日 見積もり収益が発生(管理画面)
11月初旬 10月分の収益が確定 → 残高に加算
11月21日ごろ 残高が基準額以上なら支払い
数日後 銀行に着金AdSenseの見積もり収益と確定収益の違い、毎月の支払いスケジュールと支払い基準額、支払いが保留される主な理由、外貨収入の記帳方法を解説します。ガイドを読む →
自分用のバージョンが必要なら、作業指示プロンプトをAIチャットに貼り付けるか、スキルファイルをAIコーディングエージェントに保存してください。私たちが開発時に整理した機能、例外、テストケースが含まれています。
プロンプトとスキルは英語で提供しています。AIツールはどの言語でもよく理解できます。
Claude、ChatGPT、GeminiなどのAIチャットにそのまま貼り付けてください。
You are an experienced full-stack web developer. Build a web tool called "Google Play 収益レポート" that meets the requirements below.
## Goal
Build a web tool that signs in with Google, reads Google Play earnings reports from Cloud Storage and exports monthly totals of sales, fees, refunds, taxes and payouts to Excel.
## Core features
- Google OAuth sign-in with the devstorage.read_only scope
- List the Play Console report bucket (gs://pubsite_prod_...)
- Download and parse yearly earnings ZIP/CSV files
- Totals by transaction type, month and currency
- Export to Excel (.xlsx)
## Inputs
- Google sign-in
- Bucket URI and year
## Outputs
- Monthly settlement summary
- Excel file
## Edge cases and handling rules
- Explain missing bucket permissions
- Handle CSV encoding and delimiter differences
- Aggregate refunds (negative rows) and tax rows separately
- Stream large files
## Implementation requirements
- Requires a server-side implementation. Request read-only scopes and use report files only temporarily during the session.
- State the purpose of data use on the OAuth consent screen and in the privacy policy.
- Make the UI responsive and easy to use on mobile; label every input and keep everything keyboard accessible.
- Add a Copy button for results and show clear, friendly error messages for invalid input.
- Keep the core logic in functions separate from the UI so it can be unit-tested.
## Definition of done (test cases)
- Monthly totals from a sample CSV match a manual calculation
- Refunds reduce sales
- Clear error for a bucket without access
First outline your implementation plan in at most five lines, then write the complete code, and finally explain how to check the test cases above.Claude CodeなどのAIコーディングエージェントで .claude/skills/build-google-play-earning/SKILL.md に保存すると、このツールを作る・直すたびに再利用できます。
---
name: build-google-play-earning
description: Use when building or changing a Google Play 収益レポート tool. Build a web tool that signs in with Google, reads Google Play earnings reports from Cloud Storage and exports monthly totals of sales, fees, refunds, taxes and payouts to Excel.
---
# Build: Google Play 収益レポート
## Goal
Build a web tool that signs in with Google, reads Google Play earnings reports from Cloud Storage and exports monthly totals of sales, fees, refunds, taxes and payouts to Excel.
## Workflow
1. Review the required features, inputs and outputs below and ask about anything missing first.
2. Implement the core logic as pure functions separate from the UI.
3. Check the logic against the test cases in the verification list.
4. Build a responsive UI with an input form, a result area and a Copy button.
5. Reproduce each edge case listed under Rules and refine the error messages.
## Core features
- Google OAuth sign-in with the devstorage.read_only scope
- List the Play Console report bucket (gs://pubsite_prod_...)
- Download and parse yearly earnings ZIP/CSV files
- Totals by transaction type, month and currency
- Export to Excel (.xlsx)
## Inputs
- Google sign-in
- Bucket URI and year
## Outputs
- Monthly settlement summary
- Excel file
## Rules
- Explain missing bucket permissions
- Handle CSV encoding and delimiter differences
- Aggregate refunds (negative rows) and tax rows separately
- Stream large files
- Requires a server-side implementation. Request read-only scopes and use report files only temporarily during the session.
- State the purpose of data use on the OAuth consent screen and in the privacy policy.
## Verification
- [ ] Monthly totals from a sample CSV match a manual calculation
- [ ] Refunds reduce sales
- [ ] Clear error for a bucket without access