すべての記事
実践ガイド読了まで 8 分

Google Play のサービス アカウント権限が注文を返金できる者を決める。だからこそ機能する最小限の権限だけを付与する

Play Console の権限ひとつで、サービス アカウントはあらゆる注文を返金し、あらゆる定期購入を解約できます。返金ツールに本当に必要な Google Play のサービス アカウント権限、漏えいしたキーが各ストアで何をできるか、そしてキーの範囲制限、ローテーション、取り消しの方法を解説します。

暗いデスクの上に置かれた真鍮の鍵とノートパソコン、スマートフォン。返金を左右する Google Play のサービス アカウント権限を表している

要点

  • Google Play の Manage orders and subscriptions(注文と定期購入の管理)権限を持つ者は、注文の閲覧、注文の返金、定期購入の解約ができます。つまり、この権限を持つサービス アカウントは購入者にお金を戻せます。
  • Google の Play Developer API ガイドによると、Google Play Billing API には 2 つの Play Console 権限が必要です。View financial data, orders, and cancellation survey responses と Manage orders and subscriptions です。
  • Google Play Developer API の orders.refund メソッドは、3 年以内の一回限りの購入や定期購入の注文であればどれでも返金でき、revoke を true にすると購入者のアクセスは即座に終了します。
  • Google Cloud のサービス アカウント キーはデフォルトでは期限切れになりません。Google は、コード リポジトリにコミットされたキーは IAM で削除する必要があり、リポジトリから消すだけでは不十分だとしています。
  • Apple の In-App Purchase key では返金を発行できません。しかし App Store Server API を呼び出すことはでき、定期購入の更新日を最大 90 日延長するエンドポイントも含まれます。Apple はこの延長を取り消せないとしています。
  • App Store Connect で In-App Purchase key を生成できるのは Account Holder か Admin だけです。秘密鍵のダウンロードは一度きりで、取り消したキーは復活できません。

1 つのサービス アカウントに Play Console の権限を 2 つ与えれば、そのアカウントはアプリ内のあらゆる注文を返金できます。これは設定ミスではありません。Google が Google Play Developer API をそのように設計しているのです。だからこそ、返金ツールの裏にある JSON キーは、銀行のログイン情報と同じように扱うべきです。

多くのチームは締め切りに追われる中で一度だけ設定し、最初の API 呼び出しが成功するまで手当たり次第にチェックを入れます。このガイドはその逆を行きます。返金とチャージバックの処理に本当に必要な Google Play のサービス アカウント権限、盗まれたキーで各ストアが何を許してしまうか、そして被害範囲を小さく保つ方法を示します。

Google Play のサービス アカウント権限で実際にできること

サービス アカウントはロボットのユーザーです。Google Cloud で作成し、Play Console の Users and permissions(ユーザーと権限)でそのメールアドレスを招待します。同僚を招待するのと同じ手順です。それ以降、そのアカウントは権限が許すことを API 経由で、時間を問わず、二要素認証なしで実行できます。

課金 API に必要な 2 つの権限

Google の Play Developer API ガイドは明確です。Google Play Billing API を使うには、View financial data, orders, and cancellation survey responses(財務データ、注文、解約アンケートの回答の表示)と Manage orders and subscriptions(注文と定期購入の管理)の 2 つの権限を付与します。前者は注文の読み取りと Purchases API の利用を可能にします。お金に触れるのは後者です。

Play Console の権限Google が説明する許可内容購入者にお金を戻せるか
View financial data, orders, and cancellation survey responses財務レポート、売上レポート、注文の閲覧、Purchases API へのアクセス、解約アンケートの回答のダウンロードいいえ
Manage orders and subscriptions注文の閲覧、注文の返金、定期購入の解約はい
Admin(すべての権限)他のすべての権限に加え、ユーザーの招待と権限の変更はい。しかも自分に権限を追加できる

返金権限を持つキーでできること

Google Play Developer API の orders.refund メソッドは、ユーザーの定期購入またはアプリ内購入の注文を返金します。Google によれば 3 年より古い注文は返金できません。つまり、それより新しいものはすべて返金できます。revoke を true にすれば、購入者のアクセスは即座に終了します。定期購入では、全額返金を伴う purchases.subscriptionsv2.revoke が同じ役割を果たします。

使うつもりがあるときには、これらは正しいツールです。Google 自身の不正対策ガイダンスも、チェックに通らなかった購入はタイムアウトさせず、返金して取り消すよう勧めています。問題は、1 つのアプリにしか必要のないキーが、アカウント内のすべてのアプリに対してこれを実行できてしまうことです。

キーが漏えいしたときの金銭的損失

どれだけ手間をかける価値があるか決める前に、数字を見てください。Google Play では、Manage orders and subscriptions を持つキーは 1 回の呼び出しごとに注文を返金でき、返金のたびに売上が購入者に戻ります。スクリプトは疲れません。上限は過去 3 年分の注文履歴です。

返金しても戻ってこないコスト

返金は売上を取り消します。しかし、そのサービスを提供するために使ったお金は取り消せません。返金が顧客の選択であれ攻撃者の仕業であれ、その支出は帳簿に残ります。

  • すでに使ったコンピューティング: 購入者が受け取ったすべての生成、レンダリング、モデル応答の裏にある GPU とサーバーの時間。
  • すでに支払った API 呼び出し: モデル提供元、地図、音声、データのベンダーによるリクエスト単位の課金。
  • 払い続けるストレージ: それらのアカウントがまだサーバー上に保持しているファイルと履歴。
  • すでに送ったペイアウト: それらの購入に紐づくクリエイター、アフィリエイト、販売者への支払いは、返金と一緒には戻ってきません。

Apple 側は事情が異なる

Apple の App Store Server API には返金を発行するエンドポイントがありません。返金は Apple が決めます。しかし同じ In-App Purchase key で、購読者の更新日を最大 90 日延長できます。顧客ごとに 365 日間で 2 回まで、あるいは 1 回の一括リクエストで製品のすべての有効な購読者を対象にすることもできます。Apple は延長を取り消せないとしています。その間、購読者は課金されずにアプリを使い続けるため、コンピューティング、ストレージ、API の請求は収益ゼロのまま積み上がります。

盗まれたキーでできることManage orders and subscriptions を持つ Google Play のサービス アカウントApple In-App Purchase key
注文の返金はい、3 年以内の注文いいえ、返金するのは Apple のみ
購入者のアクセス終了はい、返金時の revokeいいえ
定期購入の解約や延長解約は可能更新日を最大 90 日延長、取り消し不可
購入データの読み取りはい、閲覧権限があればはい、取引と返金の履歴
返金審査への回答はい、orders.reviewrefundはい、Send Consumption Information
1 つのアプリへの範囲制限はい、アプリの権限で可能いいえ、キーはチームのすべてのアプリで有効

Google Play のサービス アカウント権限の範囲を絞る方法

Play Console はアカウントの権限とアプリの権限を分けています。アプリの権限は選択したアプリにのみ適用されます。この設定ひとつが、このリストの他のどの項目よりも安全性に貢献します。

アカウント全体ではなく、1 つのアプリに付与する

各サービス アカウントは、担当するアプリに対するアプリの権限で招待してください。あるゲームのための返金ツールに、瞑想アプリの返金権限は不要です。落とし穴がひとつあります。View financial data, orders, and cancellation survey responses はアカウント レベルにしか存在せず、アプリ レベルの同等の権限は View financial data(財務データの表示)という名前です。範囲を絞るときはアプリ レベルのほうを選んでください。

読み取りと返金を分ける

すべての処理に Manage orders and subscriptions が必要なわけではありません。注文を読むだけの分析は、閲覧権限だけを持つアカウントで実行できます。返金できるキーは、orders.refund、orders.reviewrefund、または revoke エンドポイントを実際に呼び出す 1 つのサービスだけに置いてください。

ロボットに Admin を与えない

Admin はすべての権限を付与し、Google はユーザーの招待と権限の管理もその権限に含めています。漏えいした Admin キーは自らのアクセスを広げたり、新しい人物を招待したりできます。どの返金ワークフローにも Admin は不要です。

ベンダーに接続方法を確認する

JSON キーのアップロードを求めるツールもあります。一方で、招待用に自社のサービス アカウントのメールアドレスを提供するツールもあり、その場合あなたのキーが手元を離れることはなく、Users and permissions からワンクリックでアクセスを削除できます。ベンダーが返金権限を必要とする場合は、どの権限を、どのアプリに、なぜ必要なのかを確認してください。

デスクでノートパソコンからアクセスを取り消している開発者。壁のフックに鍵が並び、ひとつのフックだけが空いている。Google Play のサービス アカウント権限を削除する様子を表している

キーの保管、ローテーション、取り消しの方法

両ストアとも、言い方は違っても同じことを述べています。キーをコード リポジトリに置かないこと、アプリに同梱しないこと。違いが出るのは、問題が起きた後に何が起こるかです。

Google Cloud のキーは自然には期限切れにならない

Google Cloud のガイダンスは、サービス アカウント キーにはデフォルトで有効期限がないと指摘しています。定期的にローテーションし、使わなくなったキーは無効にするよう推奨しています。キーがリポジトリに入ってしまった場合、Google はできるだけ早く IAM で削除するよう求めています。リポジトリから削除するだけでは不十分だからです。Service Account Key Exposure Response の制約を DISABLE_KEY に設定すれば、Google Cloud は検出した漏えいキーを自動で無効化することもできますが、すべての漏えいを検出できる保証はありません。

Apple のキーはダウンロードが一度きりで、取り消しは永久

In-App Purchase key を生成できるのは Account Holder か Admin だけです。Apple は公開鍵の部分を保持し、あなたは秘密鍵の .p8 ファイルを一度だけダウンロードします。Apple はコピーを保持しません。キーが侵害された疑いがある場合、Apple は App Store Connect の Users and Access, Integrations, In-App Purchase で直ちに取り消すよう求めています。取り消したキーは復活できず、そのキーで署名したプロモーション オファーも引き換えできなくなるため、取り消す前か直後にそれらのオファーを更新してください。

作業Google Play のサービス アカウントApple In-App Purchase key
作成できる人Google Cloud で作成し、Play Console の Users and permissions で招待Account Holder または Admin
シークレットを再ダウンロードできるか新しいキーを作成するいいえ、ダウンロードは一度のみ
デフォルトの有効期限なしなし、取り消すまで有効
アクセスを素早く遮断する方法IAM でキーを削除するか、Play Console でアカウントを削除App Store Connect でキーを取り消す
アクセス遮断の副作用そのアカウントを使うツールはすべて API を呼び出せなくなるそのキーで署名したプロモーション オファーが引き換え不可になる

簡単なチェックリスト

  • 処理ごとに 1 つのサービス アカウントを使い、担当するアプリだけに対するアプリの権限で招待する。
  • Manage orders and subscriptions は、実際に返金、取り消し、審査への回答を行うアカウントにだけ付与する。
  • ロボット アカウントには一切 Admin を与えない。
  • キーはシークレット マネージャーに保管し、リポジトリ、ビルドログ、モバイルアプリには決して置かない。
  • すべてのキー、その作成者、使用しているサービスを書面で一覧化し、取り消しで返金の回答が止まらないようにする。
  • 誰かがチームを離れたときやベンダーとの契約を終えたときは、Play Console の Users and permissions と App Store Connect のキーを見直す。

よくある質問

返金とチャージバックのために、サービス アカウントにはどの Play Console 権限が必要ですか?
注文の返金、定期購入の解約、注文の処理には Manage orders and subscriptions が必要で、さらに注文の閲覧権限も必要です。Google の Play Developer API ガイドは、Google Play Billing API に必要な 2 つの権限として View financial data, orders, and cancellation survey responses と Manage orders and subscriptions を挙げています。
Google Play のサービス アカウントは注文を返金できますか?
はい。Manage orders and subscriptions 権限を持っていれば可能です。Google のヘルプページによると、この権限で注文の閲覧、注文の返金、定期購入の解約ができ、orders.refund API メソッドは 3 年以内のあらゆる注文を返金できます。
App Store の In-App Purchase key を入手した人は、私の顧客に返金できますか?
いいえ。App Store Server API には返金エンドポイントがありません。返金を決めるのは Apple だからです。それでも盗まれたキーで、取引と返金の履歴の読み取り、消費情報の送信、そして定期購入の更新日を最大 90 日延長することができます。Apple はこの延長を取り消せないとしています。
Google Play のサービス アカウント キーは期限切れになりますか?
デフォルトではなりません。Google Cloud のガイダンスによると、作成してダウンロードしたキーは、設定しない限り有効期限がありません。定期的なローテーションと、使わなくなったキーの無効化が推奨されています。
サービス アカウントの JSON キーを GitHub にコミットしてしまった場合はどうすればよいですか?
すぐに Google Cloud の IAM でキーを削除し、新しいキーを作成してください。Google によると、リポジトリからキーを消すだけでは不十分です。キー自体が削除されるまで、コピーした人は誰でもそれを使えるからです。

出典と参考資料

RefundHalt

App Store と Google Play の返金を自動処理

続きを読む

次の返金リクエストは、すでに向かってきています。

異議を申し立てられなかった返金について、もう 1 通のサポートメールを読む時間で RefundHalt を設定できます。