このページでは、一般的なエラーコードとその意味、それに対するアプリやゲームでの対応について説明します。
一般的なエラーコード
次の表に、API がすべてのプラットフォームで返すエラーと、推奨される対応手順を示します。
| エラーコード | 説明 | 対応手順 |
|---|---|---|
API_NOT_AVAILABLE |
Integrity API を使用できません。Play ストアのバージョンが古いか、アプリがこの API を使用できるようになっていません。 | 1）アプリが API を使用できるようになっていることを確認します。 2）Google Play ストアを更新するようにユーザーに依頼します。 |
NETWORK_ERROR |
利用可能なネットワークが見つかりませんでした。 | ネットワーク接続を確認するようにユーザーに依頼します。 |
PLAY_STORE_NOT_FOUND |
デバイス上に公式の Play ストア アプリが見つかりませんでした。 | Google Play ストアをインストールまたは有効にするようにユーザーに依頼します。 |
PLAY_STORE_VERSION_OUTDATED |
Play ストア アプリを更新する必要があります。 | Google Play ストアを更新するようにユーザーに依頼します。 |
PLAY_STORE_ACCOUNT_NOT_FOUND |
デバイス上に Play ストア アカウントが見つかりませんでした。Play Integrity API では、未認証のリクエストがサポートされるようになっています。このエラーコードは、サポート対象外の古いバージョンの Play ストアにのみ使用されます。 | Google Play ストアにログインするようにユーザーに依頼します。 |
CANNOT_BIND_TO_SERVICE |
Play ストアでサービスにバインドできませんでした。デバイスに古いバージョンの Play ストアがインストールされている可能性があります。 | Google Play ストアを更新するようにユーザーに依頼します。 |
APP_NOT_INSTALLED |
呼び出し元アプリがインストールされていません。 | なんらかの問題が発生しており、攻撃の可能性もあります。対応手順はありません。 |
PLAY_SERVICES_NOT_FOUND |
Play 開発者サービスを利用できないか、更新する必要があります。 | Play 開発者サービスをインストールまたは更新するようにユーザーに依頼します。 |
PLAY_SERVICES_VERSION_OUTDATED |
Play 開発者サービスを更新する必要があります。 | Google Play 開発者サービスを更新するようにユーザーに依頼します。 |
TOO_MANY_REQUESTS |
呼び出し元アプリからこの API へのリクエスト数が多すぎるため、スロットリングが行われています。 | 指数バックオフで再試行します。 |
GOOGLE_SERVER_UNAVAILABLE |
Google サーバーの不明な内部エラーです。 | 指数バックオフで再試行します。 |
INTERNAL_ERROR |
不明な内部エラーです。 | 指数バックオフで再試行します。 |
NONCE_TOO_SHORT |
ノンスの長さが短すぎます。ノンスは、16 バイト以上（Base64 エンコード前）でなければなりません。 | ノンスを長くして再試行します。 |
NONCE_TOO_LONG |
ノンスの長さが長すぎます。ノンスは、500 バイト未満（Base64 エンコード前）でなければなりません。 | ノンスを短くして再試行します。 |
NONCE_IS_NOT_BASE64 |
ノンスが「Base64、ウェブセーフ、ラップなし」形式ではありません。 | 正しいノンス形式で再試行します。 |
CLOUD_PROJECT_NUMBER_IS_INVALID |
指定された Cloud プロジェクト番号は無効です。 | Play Integrity API が有効になっている Cloud プロジェクトの Cloud プロジェクト番号を使用してください。 |
APP_UID_MISMATCH |
呼び出し元アプリの UID（ユーザー ID）が Package Manager の UID と一致しません。 | なんらかの問題が発生しており、攻撃の可能性もあります。対応手順はありません。 |
ネイティブ固有のエラーコード
ネイティブのエラーコードの前には、名称の競合を避けるため、INTEGRITY_ 接頭辞が付加されています。ネイティブ API には、上記のエラーコードとは別に、次のエラーコードもあります。
| エラーコード | 説明 | 対応手順 |
|---|---|---|
INTEGRITY_INITIALIZATION_NEEDED |
IntegrityManager が初期化されていません。 | 最初に IntegrityManager_init() を呼び出します。 |
INTEGRITY_INITIALIZATION_FAILED |
Integrity API の初期化中にエラーが発生しました。 | 指数バックオフで再試行します。バグの報告を検討してください。 |
INTEGRITY_INVALID_ARGUMENT |
Integrity API に無効な引数が渡されました。 | 正しい引数で再試行します。 |