クローズドテストのGoogleログインエラー10を解決する

この記事で扱うのは、Google Playから配信されたアプリでネイティブのGoogleログインが失敗するという一つの問題です。似たように見える別のエラーと区別したうえで、フレームワーク、ほかのログインプロバイダ、テスターに報告してもらう内容を取り上げます。引用しているGoogleのページはすべて2026年10月16日に確認したもので、コミュニティからの報告はその旨を明記しています。出典は末尾にまとめています。

PlayのビルドでGoogleログインを直す

テスターがインストールしたアプリと、そのアプリ用に登録されたパッケージ名および署名SHA-1を一致させます。以下の手順を順番に進めてください。FirebaseとGoogle Cloudそれぞれの手順はその後に続きます。

FirebaseにPlayの証明書を追加する

Playの署名フィンガープリントを追加する前に、対応するAndroidアプリを選択してください。手順はFirebaseのフィンガープリントに関するヘルプとGoogleログインのガイドに沿っています。

1. Firebaseコンソールでアプリが使っているプロジェクトを開き、プロジェクトの設定 > 全般に進みます。
2. マイアプリで、失敗しているビルドとパッケージ名が一致するAndroidアプリを選択します。
3. フィンガープリントを追加をクリックし、Playアプリ署名のSHA-1を貼り付けて保存します。既存のフィンガープリントを置き換えるのではなく、その横に追加してください。
4. Authentication > Sign-in methodで、Googleが有効になっていることを確認します。
5. Firebaseで更新版のgoogle-services.jsonのダウンロードを求められた場合は、プロジェクト内のファイルを置き換えます。Firebaseはこのファイルについて「Googleログインに必要なOAuthクライアント情報が含まれています」と説明しているため、ファイルが変われば新しいビルドが必要です。ファイルのプロジェクトとパッケージが、失敗しているアプリと一致しているかも確認してください。

SHA-256は、特定のFirebaseサービスが求める場合にのみ追加してください。たとえば電話番号認証では、Play Integrityを使う経路でSHA-256を使います。Googleログイン自体が頼りにしているのはSHA-1です。

Firebaseを使わずにGoogle Cloudで設定する

2つのOAuthクライアントはそれぞれ別の役割を持っています。Androidクライアントはアプリを登録するもので、トークンのリクエストに使うのはウェブクライアントIDです。

1. クライアントIDを発行したプロジェクトを選択し、Google Auth Platform > クライアントを開きます（Google Cloudのヘルプ）。
2. 新しく作成する前に、このパッケージ名とSHA-1を持つAndroidクライアントがすでにないか確認します。
3. ない場合はクライアントを作成を選び、アプリケーションの種類をAndroidに設定して、名前、パッケージ名、Playアプリ署名のSHA-1を入力し、作成をクリックします。AndroidのフォームにあるのはSHA-1の欄で、SHA-256はここには入れません。
4. 必要なパッケージと証明書の組み合わせを、たとえばデバッグ用、ローカルのリリース用、Play用のようにそれぞれ登録します。
5. トークンのリクエスト用にウェブクライアントはそのまま残し、クライアントシークレットは決してアプリ内に入れないでください。

修正できたことを確かめる

一度ログインに成功しただけでは、リリースが直ったことの証明にはなりません。このチェックリストはGoogleのルールではなく、私たちが推奨する受け入れテストです。最後の行が重要なのは、ある開発者のケースで一度はログインに成功したのに次のログインで失敗したためです。これはセッションの問題で、1回の確認では見逃してしまいます。

デバッグではログインできるのに、クローズドテストで失敗するのはなぜですか？

Google Play経由でインストールされたアプリは、ローカルでインストールしたAPKとは署名者が異なる場合があります。Googleのクライアント認証ガイドには「Android Studioはアプリをデバッグ証明書で自動的に署名します」とあります。自分でビルドしたリリース版は、そのバリアントに設定されている鍵で署名されます。Playアプリ署名を使う場合、アップロードするバンドルにはアップロード鍵で署名し、テスターが受け取るAPKにはGoogleがアプリ署名鍵で署名します。

これらの鍵は役割が異なりますが、値が常に異なるとは限りません。独自の署名鍵を提供することもでき、1つの鍵を2つの役割に使う構成もあります。鍵のラベルではなく、実際のフィンガープリントを比較してください。

フィンガープリントを自分で読み取る

自分のマシンでのビルドについては、Gradleの署名レポートですべてのバリアントのSHA-1とSHA-256を表示でき、keytoolでデバッグ用キーストアを直接読み取れます（求められたらキーストアのパスワードを入力してください）。

./gradlew signingReport

keytool -list -v -alias androiddebugkey -keystore ~/.android/debug.keystore

ローカルの署名レポートでは、Playから配信されたアプリに何が署名したかはわかりません。失敗しているビルドそのものを確認するには、クローズドテストからアプリを端末にインストールし、adbで取り出して、apksignerで証明書を表示します。Googleはapksignerについて「APKの署名証明書に関する情報」を表示すると説明しています。パッケージ名は置き換え、パスは最初のコマンドが表示したものを使ってください。

adb shell pm path com.example.app
adb pull /data/app/.../base.apk failing-play.apk
apksigner verify --print-certs failing-play.apk

SHA-1を追加したのにまだ失敗します

これ以上設定を変える前に、失敗しているAPKの証明書、最終的なアプリケーションID、クライアントIDを比較してください。次の手順表を上から順に進めます。各行で1つの層ずつ原因を除外していきます。

4行目は机上の話ではありません。2026年9月に報告されたExpoのケースでは、フィンガープリントを追加しても何も変わらず、原因はバックエンドが受け入れるクライアントIDの誤字でした。

複数の署名証明書、またはアップグレードした鍵

1つのアプリで、複数の署名IDの登録が必要になることがあります。Googleの現在のPlayアプリ署名のヘルプでは、3つのアプリ署名鍵を使うハイブリッド署名について説明しており、それぞれのフィンガープリントを登録するよう求めています。また、署名鍵をアップグレードしたアプリでも、古い鍵で署名されたインストールが残っている場合があります。インストールされているアプリが実際に持っている署名IDを登録し、まだ機能している古い登録は削除しないでください。鍵のローテーションはこの記事の範囲外であり、ログインの修正方法でもありません。

別のプロジェクトがこのパッケージとSHA-1をすでに使っている

Firebaseの競合に関するヘルプによると、パッケージ名とSHA-1の組み合わせは「すべてのFirebaseプロジェクトとGoogle Cloudプロジェクトを通じて一意である必要があります」。別のプロジェクトが保持しているためにコンソールがフィンガープリントを受け付けない場合は、何かを削除する前に、そのOAuthクライアントをどのプロジェクトが所有しているかを特定してください。競合の特定はGoogleのサポートに手伝ってもらえます。当て推量で有効なクライアントやプロジェクトを削除しないでください。

エラー10は12500、12501、canceledと同じですか？

いいえ。ログインの失敗をすべて同じ問題として扱う前に、正確なエラーと、それを出したライブラリを確認してください。Googleの共通ステータスコードのリファレンスでは、DEVELOPER_ERROR = 10を「アプリケーションの設定が誤っています」と定義しています。下のその他のコードは、Googleの旧play-services-auth 21.6.0 SDKのものです。

旧Googleログイン（Google Sign-In）とCredential Manager

GoogleのPlay開発者サービスのリリースノートには、2024年4月16日にplay-services-baseでGoogle Sign-In APIが非推奨になったことが記載されており、Googleは2024年9月11日にCredential Managerへの移行を発表しました。その後、これらのAPIは2026年8月26日にplay-services-auth 22.0.0から、2026年9月17日にplay-services-base 18.11.0から削除され、「Removed the APIs related to Google Sign-in.」（Google Sign-in関連のAPIを削除）と記載されています。これはSDKの変更であり、すでにインストールされているアプリの提供終了日を定めたものではありません。新しいコードやアップグレードでは、Googleの移行ガイドに従ってください。

2つのAPIは失敗の仕方が異なります。Credential Managerにはエラー10がなく、そのトラブルシューティングガイドは「大量の"キャンセル"は、実際には設定ミスを示している可能性があります」と注意を促しています。つまりキャンセルは、設定の不具合のこともあれば本当のキャンセルのこともあり、NoCredentialExceptionはさらに別のシグナルです。

Flutter、React Native、Expo、Unityの確認事項

上で説明したネイティブの署名IDの確認はすべてのフレームワークに当てはまりますが、セットアップ、初期化、ビルド設定はフレームワークごとに異なります。使っているフレームワークの手順と、アプリで実際に解決されるライブラリのバージョンに合わせてください。

React Nativeでは、ライブラリのメンテナーが提供している設定チェックを、プロジェクトのルートから実行できます。

npx @react-native-google-signin/config-doctor

Supabase、Facebook、Apple、Auth0では何が変わりますか？

どの証明書、クライアントID、コールバックを一致させる必要があるかは、プロバイダとログインのフローによって決まります。ネイティブのGoogleログインならGoogleのSHA-1が答えですが、ほかのプロバイダでは、ハッシュの種類や形式が違ったり、そもそも関係なかったりします。

テスターは開発者に何を送ればよいですか？

役に立つ報告とは、失敗しているPlayのビルドと、ログインが止まる正確な箇所がわかるものです。テスターが何度試してもOAuthの登録は直らないため、求められるのは粘り強さではなく証拠です。このテンプレートをコピーしてテスターに送ってください。

アプリとPlayのテスト用リンク：
インストールしたアプリのバージョンまたはビルド：
インストール元：Playのクローズドテスト / その他の経路
端末とAndroidのバージョン：
日付、時刻、タイムゾーン：
正確なエラーの文言、または個人情報を伏せたスクリーンショット：
止まった箇所：アカウント選択の前 / アカウントを選んだ後 / アプリに戻った後
ほかのログイン方法ならアプリを開けたか：
再テストの結果とバージョン：

修正している間も、テスターにはテストへのオプトインを続けてもらってください。パスワード、OAuthトークン、秘密鍵、Play Consoleへのアクセス権は決して求めないでください。変更後は、同じテスターにログインが必要な機能を開いてもらい、ログアウトしてから再度ログインしてもらって、そのバージョンと結果を記録してもらいます。

エラー10はクローズドテストや製品版へのアクセスに影響しますか？

ログインの設定エラーは、テストへの登録とは別の問題です。エラー10はPlayのポリシーによる却下コードではなく、私たちが確認した範囲では、これでテスターのオプトイン期間がリセットされるとするGoogleのルールはありません。Googleのテスト要件のページでは、クローズドテスト中にアプリを改善することが推奨されています。テスターにはオプトインを続けてもらい、修正は同じクローズドテストのトラックに配信してください。これは公開されているルールの読み取りであり、あらゆるケースを保証するものではありません。

とはいえ、ログインが壊れていることは問題です。Google Playの機能に関するポリシーには「クラッシュ、強制終了、フリーズなど、正常に機能しないアプリは許可されません」とあり、ログインの壁があるとテスターは本来テストすべき機能にたどり着けません。製品版へのアクセスを申請する前に修正し、審査担当者には実際にログインできる情報を渡してください。すでに審査結果が届いている場合は、Broken Functionalityによる却下をご覧ください。

参考までに：2023年11月13日以降に作成された個人用デベロッパーアカウントでは、そのアプリの製品版へのアクセスを申請する前に、12人以上のテスターが14日間連続でオプトインしている必要があります。申請後については、Googleは「審査には通常7日以内かかりますが、それ以上かかる場合もあります」としています。テスターが人数に数えられていない場合は、ログインに手を付ける前に招待の方法を確認してください。

よくある質問

まとめ

このページで最も変わりやすい情報は、Play ConsoleとFirebaseのメニューのラベルです。上記の経路がお使いのコンソールと一致しなくなった場合は、Playアプリ署名はProtected with Playの中、フィンガープリントはFirebaseのプロジェクトの設定にあるAndroidアプリの項目を探してください。