gpc-cli-usage について
gpc-cli-usage は、gpc コマンドラインで Google Play Console のワークフローを扱うエージェント向けスキルです。コマンド確認、認証設定、出力形式、安全確認を扱います。
主な機能
- 01コマンドとフラグの確認
- 02認証設定とプロファイル切り替え
- 03複数の出力形式
- 04ドライランと明示的な確認
- 05認証診断
活用シーン
- 01自動処理向けにアプリ一覧を JSON で取得
- 02サービスアカウント認証と既定パッケージの設定
- 03認証や API アクセスの問題調査
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ androidpoet/ playconsole-cli-skills --skill gpc-cli-usageインストール後、Claude Code で/gpc-cli-usageを入力して読み込まれたか確認します。
詳細
GPC CLI の使い方
Google Play Console のワークフローで gpc コマンドを実行または設計する必要がある場合に、このスキルを使用します。
コマンドの確認
実行前に、コマンドとフラグを必ず確認してください。
gpc --help
gpc tracks --help
gpc bundles upload --help
フラグの規則
- 明示的なロングフラグを使用します:
--package、--track、--output。 - 対話形式のプロンプトはありません。破壊的な操作には
--confirmが必要です。 - 短縮エイリアス:
-p(パッケージ)、-o(出力)、-q(静音)。
出力形式
デフォルトの出力は最小化された JSON です。利用可能な形式は次のとおりです。
gpc apps list -o json # Default, machine-readable
gpc apps list -o table # Human-readable columns
gpc apps list -o yaml # YAML format
gpc apps list -o csv # CSV for spreadsheets
gpc apps list -o tsv # Tab-separated
gpc apps list -o minimal # Compact output
gpc apps list --pretty # Pretty-print JSON
デバッグには --pretty を使用します。自動化や jq へのパイプ処理には -o json(デフォルト)を使用します。
認証
プロファイルを設定する
gpc auth login --credentials /path/to/service-account.json --name myprofile --default-package com.example.app
プロファイルを切り替える
gpc auth list
gpc auth current
gpc auth switch --name otherprofile
CI 用の環境変数
| 変数 | 用途 |
|---|---|
GPC_CREDENTIALS_PATH | サービスアカウント JSON のパス |
GPC_CREDENTIALS_B64 | Base64 エンコードされた認証情報 |
GPC_PACKAGE | デフォルトのパッケージ名 |
GPC_PROFILE | デフォルトの認証プロファイル |
GPC_OUTPUT | デフォルトの出力形式 |
診断
gpc doctor # Check config, credentials, API access
gpc doctor --verbose # Detailed diagnostic output
グローバルフラグ
| フラグ | 短縮形 | 説明 |
|---|---|---|
--package | -p | アプリのパッケージ名(または GPC_PACKAGE) |
--output | -o | 出力形式(json、table、yaml、csv、tsv、minimal) |
--pretty | JSON を整形して表示 | |
--quiet | -q | 必須ではない出力を抑制 |
--debug | API リクエスト/レスポンスを表示 | |
--dry-run | 変更を適用せずにプレビュー | |
--timeout | リクエストのタイムアウト(デフォルトは 60s) | |
--profile | 認証プロファイル名 |
安全性
- 破壊的な操作の前に
--dry-runを使用します。 --confirmフラグを明示的に使用します。コマンドにyesをパイプで渡してはいけません。- 認証の問題をトラブルシューティングする前に、
gpc doctorを確認します。
エージェントの動作
GPC_PACKAGEが設定済みであることを確認できている場合を除き、必ず--packageを明示的に渡します。- 解析には
--output jsonを優先し、ユーザーに結果を表示する場合は--output tableを使用します。 - 認証エラーが発生した場合は、まず
gpc doctorを実行します。
コメント
Markdown 対応