mcpField
G
gplay-cli-usage

gplay-cli-usage

github.com/tamtom開発52451 回インストール13 週間前に更新
リポジトリ

gplay-cli-usage について

gplay-cli-usageは、Google Play Consoleのコマンド実行や設計を支援するスキルです。アプリのリリースやデベロッパーアカウントを管理する人向けに、認証、トラック管理からレポート、メタデータ、アプリ指標までのCLI操作を扱います。

主な機能

  1. 01認証とデベロッパーアカウントの管理
  2. 02アプリのリリースとトラック管理
  3. 03AAB、ストア掲載情報、画像の管理
  4. 04メタデータの同期と検証
  5. 05アプリ指標とレポートの確認

活用シーン

  1. 01テストまたは本番トラックへのアプリ公開
  2. 02トラック間でのリリース昇格
  3. 03ストアメタデータの検証または同期
  4. 04クラッシュ指標や財務レポートの確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/tamtom/gplay-cli-skills --skill gplay-cli-usage

インストール後、Claude Code で/gplay-cli-usageを入力して読み込まれたか確認します。

詳細

Google Play CLI の使用方法

Google Play Console 用の gplay コマンドを実行または設計する必要がある場合は、このスキルを使用してください。

コマンドの確認

  • --help を使って、コマンドとフラグを必ず確認してください。
    • gplay --help
    • gplay tracks --help
    • gplay tracks list --help

使用可能なコマンド

コマンド説明
gplay auth認証とプロファイルの管理
gplay appsデベロッパーアカウント内のアプリの一覧表示と管理
gplay initデフォルト設定でプロジェクトを初期化
gplay release高レベルのリリースワークフロー
gplay promoteトラック間でリリースを昇格
gplay rollout段階的なロールアウトを管理
gplay tracksトラック管理
gplay bundlesバンドル（AAB）管理
gplay edits編集セッション管理
gplay listingsストア掲載情報管理
gplay imagesスクリーンショットと画像の管理
gplay syncメタデータの同期（インポート／エクスポート）
gplay validateメタデータのオフライン検証
gplay vitalsアプリの健全性モニタリング（クラッシュ、パフォーマンス、エラー）
gplay usersデベロッパーアカウントのユーザー管理
gplay grantsアプリレベルの権限付与
gplay reports財務レポートと統計レポート（GCS から一覧表示／ダウンロード）
gplay docs generateCLI ドキュメントを生成
gplay migrate移行ツール（Fastlane からの移行など）
gplay notify通知を送信（Slack、Webhook など）
gplay updateCLI バイナリを自己更新

フラグの規則

  • 明示的なロングフラグ（例：--package、--output）を使用してください。
  • 対話型プロンプトはありません。破壊的な操作には --confirm が必要です。
  • ユーザーがすべてのページを求める場合は、--paginate を使用してください。
  • 変更を実行せずにプレビューするには、--dry-run を使用してください（release、migrate、その他の書き込みコマンドでサポートされています）。

出力形式

  • デフォルトの出力は最小化された JSON です。
  • 人が読みやすい出力には、--output table または --output markdown のみを使用してください。
  • --pretty は JSON 出力でのみ有効です。
  • GPLAY_DEFAULT_OUTPUT 環境変数を設定すると、デフォルトの出力形式を変更できます（例：GPLAY_DEFAULT_OUTPUT=table）。

認証とデフォルト値

  • サービスアカウント認証を優先してください：gplay auth login --service-account /path/to/sa.json。
  • フォールバック環境変数：GPLAY_SERVICE_ACCOUNT、GPLAY_PACKAGE。
  • GPLAY_PACKAGE でデフォルトのパッケージ名を指定できます。

タイムアウト

  • GPLAY_TIMEOUT／GPLAY_TIMEOUT_SECONDS はリクエストのタイムアウトを制御します。
  • GPLAY_UPLOAD_TIMEOUT／GPLAY_UPLOAD_TIMEOUT_SECONDS はアップロードのタイムアウトを制御します。

環境変数

変数用途
GPLAY_SERVICE_ACCOUNTサービスアカウント JSON のパス
GPLAY_PACKAGEデフォルトのパッケージ名
GPLAY_PROFILEアクティブなプロファイル名
GPLAY_TIMEOUTリクエストのタイムアウト（例：90s、2m）
GPLAY_TIMEOUT_SECONDSタイムアウト秒数（代替形式）
GPLAY_UPLOAD_TIMEOUTアップロードのタイムアウト（例：5m、10m）
GPLAY_DEBUGデバッグログを有効化（HTTP リクエストの場合は api を設定）
GPLAY_NO_UPDATE更新チェックを無効化
GPLAY_MAX_RETRIES失敗したリクエストの最大再試行回数（デフォルト：3）
GPLAY_RETRY_DELAY再試行間の基本待機時間（デフォルト：1s）
GPLAY_DEFAULT_OUTPUTデフォルトの出力形式（json、table、markdown）

よく使うパターン

ページネーションを使った一覧表示
gplay tracks list --package com.example.app --paginate
jq で JSON 出力を解析
gplay tracks list --package com.example.app | jq '.tracks[] | select(.track == "production")'
プロファイルを使用
# Create/login a named profile
gplay auth login --profile production --service-account /path/to/prod-sa.json
# Switch the active profile
gplay auth switch --profile production
gplay --profile production tracks list --package com.example.app
デバッグモード
GPLAY_DEBUG=1 gplay tracks list --package com.example.app
GPLAY_DEBUG=api gplay tracks list --package com.example.app  # HTTP details
ドライラン（変更のプレビュー）
gplay release --package com.example.app --track beta --bundle app.aab --dry-run
gplay migrate fastlane --source ./fastlane/metadata/android --output-dir ./metadata --dry-run
プロジェクトを初期化
gplay init --package com.example.app --service-account /path/to/sa.json
デベロッパーアカウント内のアプリを一覧表示
gplay apps list
gplay apps list --output table
gplay apps list --paginate
CLI ドキュメントを生成
gplay docs generate --output-file ./GPLAY.md
gplay docs generate --output-file -   # write to stdout
自己更新
gplay update
gplay update --check  # Check for updates without installing
財務レポート
# --bucket-id is the GCS bucket ID/URI from Play Console > Download reports > Copy Cloud Storage URI
gplay reports financial list --bucket-id <id>
gplay reports financial list --bucket-id <id> --type earnings --from 2026-01 --to 2026-06
gplay reports financial download --bucket-id <id> --from 2026-01 --type earnings --dir ./reports
統計レポート
gplay reports stats list --bucket-id <id>
gplay reports stats list --bucket-id <id> --package com.example.app --type installs
gplay reports stats download --bucket-id <id> --package com.example.app --from 2026-01 --type installs --dir ./reports
通知を送信
gplay notify send --webhook-url https://hooks.slack.com/... --message "Release deployed"

編集セッション

ほとんどの書き込み操作では編集セッションが必要です。

# Create edit
gplay edits create --package com.example.app
# Returns: edit_id

# Make changes
gplay bundles upload --package com.example.app --edit <edit_id> --file app.aab

# Commit changes (publishes)
gplay edits commit --package com.example.app --edit <edit_id>

高レベルコマンドと手動コマンド

  • 高レベル：gplay release（編集を作成し、アップロードしてコミットします）
  • 手動：gplay edits create → gplay bundles upload → gplay edits commit

手軽に実行する場合は高レベルコマンドを、細かく制御する場合は手動コマンドを使用してください。

コメント

Markdown 対応