このページでは、アプリ、ゲーム、SDK で Play Integrity API を使用するようにセットアップする方法について説明します。API を統合するには、Google Cloud プロジェクトが必要です。これは、リクエストの作成を開始するために必要です。その後、Google Play Console（アプリの場合）または Google Play SDK Console（SDK の場合）で Google Cloud プロジェクトをリンクできます。追加の構成オプション、テスト機能、API レポートにアクセスし、1 日あたりのリクエスト割り当ての引き上げをリクエストするには、プロジェクトをリンクする必要があります。
Play Integrity API を有効にする
Play Integrity API を呼び出すすべてのアプリまたは SDK には、API を使用して使用状況をモニタリングするための Google Cloud プロジェクトが必要です。これは、すべての統合で必須の最初のステップです。Google Cloud コンソールで Play Integrity API を有効にすることも、Cloud プロジェクトを Google Play にリンクする手順に直接進んで Play Integrity API を有効にすることもできます。
Google Cloud コンソールで、新しいクラウド プロジェクトを作成するか、Play Integrity API で使用する既存のクラウド プロジェクトを選択します。
- [API とサービス] に移動します。
- [API とサービスの有効化] を選択します。
- 「Play Integrity API」を検索します。
- [有効にする] をクリックします。
これで、Play Integrity API をアプリに統合できます。上級者向け機能にアクセスして割り当てを増やすには、リンクの手順に進む必要があります。
Google Play にリンクする（推奨）
Google Cloud プロジェクトをアプリまたは SDK にリンクするには、次の手順を行います。
Google Play のアプリとゲーム
Google Play で配信されるアプリは、Google Play Console で Google Cloud プロジェクトにリンクして、追加機能を有効にし、1 日あたりの API 割り当ての増加をリクエストする必要があります。
- Google Play Console を開き、アプリを選択します。
- [Google Play による保護] に移動します。
- [Play Integrity API] の横にある [開始] ボタンを選択して、[Play Integrity API の設定] に移動します。
- [クラウド プロジェクトをリンク] ボタンをクリックします。
- Play Integrity API で使用する Google Cloud プロジェクトを選択します。プロジェクトで Play Integrity API がまだ有効になっていない場合は、リンクすると自動的に有効になります。
Google Play SDK Console の SDK プロバイダ向け
Google Play SDK Console を使用している SDK プロバイダは、Google Cloud プロジェクトをリンクして、API の使用を、SDK を使用する個々のアプリではなく SDK に関連付けることができます。また、追加機能を有効にしたり、1 日あたりの API 割り当ての増加をリクエストしたりすることもできます。Google Play SDK Console へのアクセスには利用条件が適用されます。
- Google Play SDK Console を開き、SDK を選択します。
- [SDK の整合性] に移動します。
- [Play Integrity API] で [Cloud プロジェクトをリンク] をクリックします。
- Play Integrity API で使用する Google Cloud プロジェクトを選択します。プロジェクトで Play Integrity API がまだ有効になっていない場合は、リンクすると自動的に有効になります。
Play Integrity API の使用量上限を理解する
アプリまたは SDK には、関連付けられた Cloud プロジェクト番号に紐づけられた、1 日あたり合計 10,000 件のリクエスト上限がデフォルトで適用されます。より多くのボリュームが予想される場合は、割り当ての増加をリクエストできます。
| アクション | 1 日の割り当て | メモ |
|---|---|---|
| トークン リクエスト | 10,000 | クラシック リクエストと標準トークンの準備の間で共有 |
| Google のサーバーでのトークンの復号 | 10,000 | クラシック リクエストと標準リクエストで共有 |
リクエストの 1 日あたりの上限を引き上げる
割り当ての増加は、利用条件の対象となります。割り当ての増加は、クライアントサイドのトークン生成とサーバーサイドの復号呼び出しの両方に適用されます。リクエストの処理には最長で 1 週間かかることがあります。サービスの中断を回避するために、Google Cloud コンソールで Play Integrity API の使用量をモニタリングし、割り当てアラートを設定することをおすすめします。
割り当てを引き上げた後も、クラシック リクエストは、リクエスト頻度が低く高価値を生むアクションに制限して、ユーザーのバッテリーとデータ使用量の節約に努めてください。
Google Play のアプリとゲーム
割り当ての引き上げの対象となるには、他の配信チャネルに加えて Google Play でもアプリが利用できる必要があります。Google Play Console で Google Cloud プロジェクトをアプリにリンクする必要があります。リンクされていないプロジェクトからの割り当てリクエストは拒否されます。
上限の引き上げをリクエストするには:
- Google Play Console で、関連する Google Cloud プロジェクトをリンクします。
- 適切な再試行戦略などの API ロジックを正しく実装していることを確認します。
- 割り当てリクエスト フォームを送信します。
Google Play SDK Console の SDK プロバイダ向け
割り当ての引き上げの対象となるには、Google Play SDK Console で SDK を申請し、そこでクラウド プロジェクトを SDK にリンクする必要があります。Google Play SDK Console へのアクセスには利用条件が適用されます。
上限の引き上げをリクエストするには:
- Google Play SDK Console で Google Cloud プロジェクトをリンクします。
- デベロッパー サポート フォームに記入します。
公開コメントで、SDK の詳細、ユースケース、実行している API リクエストのタイプ（標準、クラシック、またはその両方）、リクエストの頻度、1 日あたりのリクエスト数の上限を指定します。
Play Integrity API をアプリに統合する
Play Integrity API をアプリまたは SDK に統合するには、開発環境に応じて次のいずれかを実行します。
Kotlin または Java
Play Integrity API 用の最新の Android ライブラリは、Google の Maven リポジトリから入手できます。アプリの build.gradle ファイルに次の依存関係を追加します。
implementation 'com.google.android.play:integrity:1.6.0'
Unity
以下のセクションでは、Unity プロジェクトに Google Play Integrity API を統合して設定する方法について説明します。サポートされている Unity のバージョン、インストール方法、環境の設定についても説明します。
サポートされている Unity のバージョン
- 2019.x、2020.x 以降のすべてのバージョンがサポートされています。
- Unity 2018.x を使用している場合は、バージョン 2018.4 以降がサポートされています。
- Unity 2017.x 以前のバージョンはサポートされていません。
開発環境を設定する
OpenUPM-CLI
OpenUPM CLI がインストールされている場合は、次のコマンドで OpenUPM レジストリをインストールできます。
openupm add com.google.play.integrityOpenUPM
Unity のメニュー オプション [Edit]（編集）> [Project Settings]（プロジェクト設定）> [Package Manager] を選択して、Package Manager の設定画面を開きます。
OpenUPM をスコープ付きレジストリとして [Package Manager] ウィンドウに追加します。
Name: package.openupm.com URL: https://package.openupm.com Scopes: com.google.external-dependency-manager com.google.play.common com.google.play.core com.google.play.integrityUnity のメニュー オプション [Window]（ウィンドウ）> [Package Manager]を選択して、Package Manager メニューを開きます。
マネージャー スコープのプルダウンで [My Registries]（マイレジストリ）を選択します。
パッケージ リストから [Google Play Integrity plugin for Unity] パッケージを選択し、[Install] を押します。
GitHub からインポート
GitHub から最新の
.unitypackageリリースをダウンロードします。Unity メニュー オプションの [Assets]（アセット）> [Import Package]（パッケージをインポート）> [Custom Package]（カスタム パッケージ）を選択し、すべてのアイテムをインポートして、
.unitypackageファイルをインポートします。
Unreal Engine
以降のセクションでは、Unreal Engine プロジェクトに Google Play Integrity API を統合して設定する方法について説明します。
サポートされている Unreal Engine のバージョン
このプラグインは、Unreal Engine 5.0 以降のすべてのバージョンをサポートしています。
開発環境を設定する
GitHub リポジトリから Play Unreal Engine プラグインをダウンロードします。
Unreal Engine プロジェクトの
Pluginsフォルダ内にGooglePlayフォルダをコピーします。Unreal Engine プロジェクトを開き、[Edit] → [Plugins] をクリックします。
「Google Play」を検索し、[有効] チェックボックスをオンにします。
ゲーム プロジェクトを再起動してビルドをトリガーします。
プロジェクトの
Build.csファイルを開き、PlayIntegrityモジュールをPublicDependencyModuleNamesに追加します。using UnrealBuildTool; public class MyGame : ModuleRules { public MyGame(ReadOnlyTargetRules Target) : base(Target) { // ... PublicDependencyModuleNames.Add("PlayIntegrity"); // ... } }
ネイティブ
ネイティブ広告の設定ガイドに沿って操作します。詳しくは、Play Integrity のネイティブ API リファレンス ドキュメントをご覧ください。
API レスポンスを設定する（省略可）
API レスポンスには、すべてのリクエストで返されるデフォルトの判定結果が含まれます。Google Play Console または Google Play SDK Console で Cloud プロジェクトをリンクしている場合は、API レスポンスをカスタマイズして追加情報を含めることができます。
デフォルトの完全性判定の結果
Play Integrity API レスポンスでは、デフォルトで以下の完全性判定の結果が返されます。
| レスポンス フィールド | 値 | 説明 |
|---|---|---|
| Play アカウントの詳細 | LICENSED |
ユーザーはアプリの利用資格を持っています。つまり、ユーザーはデバイスの Google Play からアプリをインストールまたは更新しました。 |
UNLICENSED |
ユーザーはアプリの利用資格を持っていません。ユーザーがアプリをサイドローディングした場合や、アプリを Google Play から取得したのではない場合などが該当します。 | |
UNEVALUATED |
要件が満たされていないため、ライセンスの詳細は評価されませんでした。次のような原因が考えられます。
|
|
| アプリの完全性 | PLAY_RECOGNIZED |
アプリと証明書が、Google Play で配信されているバージョンと一致します。 |
UNRECOGNIZED_VERSION |
証明書またはパッケージ名が Google Play の記録と一致しません。 | |
UNEVALUATED |
アプリの完全性は評価されませんでした。デバイスの信頼性が十分でないなど、要件が満たされていませんでした。 | |
| デバイスの完全性 | MEETS_DEVICE_INTEGRITY |
アプリは、正規の認定済み Android デバイスで動作しています。Android 13 以降では、デバイスのブートローダーがロックされていること、読み込まれた Android OS が認定デバイス メーカーのイメージであることを示すハードウェア格納型の証明書があります。 |
| 空（空の値） | アプリは、API フックなどの攻撃や root 権限取得などのシステム侵害の兆候があるデバイス、または Google Play の完全性チェックに合格していない仮想デバイス（エミュレータなど）で動作しています。 |
PC 版 Google Play Games
PC 版 Google Play Games に配信する場合は、デバイスの完全性判定の結果において次の追加ラベルの受け取りが自動的にオプトインされます。
| レスポンス フィールド | ラベル | 説明 |
|---|---|---|
| デバイスの完全性 | MEETS_VIRTUAL_INTEGRITY |
アプリは、Google Play 開発者サービスを搭載した Android Emulator で動作しています。このエミュレータはシステム完全性チェックに合格し、Android の互換性に関する主要な要件を満たしています。 |
オプションの完全性判定の結果
Google Play Console または Google Play SDK Console で Cloud プロジェクトをリンクしている場合は、追加情報の受け取りをオプトインできます。
変更を加えるには、Google Play Console にアクセスし、[Google Play による保護] に移動します。[Play Integrity API] の横にある [管理] をクリックします。[レスポンスを変更] をクリックして編集を行い、変更を保存します。
デバイス情報
deviceIntegrity 判定の追加のデバイスラベルは、アプリが実行されているデバイス環境に関する詳細情報を提供します。1 つのデバイスがそれぞれの条件を満たしている場合、複数のラベルが返されます。これらのラベルを使用して、段階的な違反措置戦略を作成できます。たとえば、3 つのラベル（MEETS_STRONG_INTEGRITY、MEETS_DEVICE_INTEGRITY、MEETS_BASIC_INTEGRITY）を返すデバイスは、1 つのラベル（MEETS_BASIC_INTEGRITY）のみを返すデバイスよりも信頼性が高くなります。
デバイス属性は、デバイス上の Android OS の Android SDK バージョンを示します。今後、他のデバイス属性で拡張される可能性があります。
最近のデバイスのアクティビティは、LEVEL_1（リクエスト数が少ない）から LEVEL_4（リクエスト数が多い）の範囲のレベルを返します。アクティビティ レベルが高い場合は、信頼できないデバイスに不正に配布するために、過剰なトークンを生成するためにデバイスが使用されている可能性があります。
デバイスの呼び出しを使用すると、特定のデバイスにデバイスごとのカスタムデータを保存できます。このデータは、後で同じデバイスにアプリを再インストールしたときに確実に取得できます。
オプション情報の受け取りをオプトインすると、API レスポンスの判定結果に新しいフィールドとレスポンスが追加されます。
| レスポンス フィールド | ラベル | 説明 | |
|---|---|---|---|
| デバイスの完全性 | MEETS_BASIC_INTEGRITY |
アプリは、基本的なシステム完全性チェックに合格したデバイスで動作しています。デバイスのブートローダーはロックまたはロック解除でき、ブート状態は確認済みまたは未確認にできます。デバイスが認定されていない可能性があります。その場合、Google はセキュリティ、プライバシー、アプリの互換性を保証できません。Android 13 以降では、MEETS_BASIC_INTEGRITY の判定には、Google が提供する証明書の
ルート オブ トラストが必要です。 |
|
MEETS_STRONG_INTEGRITY |
アプリは、最新のセキュリティ アップデートが適用された、正規の認定済み Android デバイスで動作しています。
|
||
| デバイスの属性 | sdkVersion: 19, 20, ..., 37 |
デバイスで実行されている Android OS の SDK バージョン。
返された番号は Build.VERSION_CODES にマッピングされます。 |
|
| 空（空の値） | 要件が満たされていないため、SDK バージョンは評価されませんでした。この場合、sdkVersion フィールドは設定されていません。したがって、deviceAttributes フィールドは空です。これには、以下のような理由が考えられます。
|
||
| このデバイスで過去 1 時間にアプリごとに行われた標準 API 完全性トークン リクエスト | 過去 1 時間にこのデバイスでアプリごとに実行されたクラシック API 完全性トークン リクエスト | ||
| 最近のデバイスのアクティビティ | LEVEL_1（最低） |
10 本以下 | 5 以下 |
LEVEL_2 |
11 ～ 25 | 6 ～ 10 | |
LEVEL_3 |
26 ～ 50 | 11 ～ 15 | |
LEVEL_4 （最高） |
51 件以上 | 16 以上 | |
UNEVALUATED |
最近のデバイスのアクティビティは評価されませんでした。これには、以下のような理由が考えられます。
|
||
| デバイスの呼び出し | values: bitFirst, bitSecond, bitThird |
これらは、特定のデバイスに対して過去に設定したビット値です。各ビットの意味は、ユーザーが決定します。3 つのビット値はデフォルトで false です。 | |
writeDates: yyyymmFirst, yyyymmSecond, yyyymmThird |
これらは、ビット値の書き込み日（UTC）の正確な年月です。呼び出すビットの書き込み日は、ビットが true に設定されるたびに更新され、ビットが false に設定されると削除されます。 | ||
環境の詳細
アプリアクセス リスクでは、画面をキャプチャしたり、オーバーレイを表示したり、デバイスを操作したりする可能性のあるアプリが他に実行されているかどうかを確認できます。Google Play で認識されている検証済みのユーザー補助サービスは、この判定結果から自動的に除外されます。
Play プロテクトの判定結果により、デバイスで Google Play プロテクトが有効になっているかどうか、既知のマルウェアが検出されたかどうかを確認できます。
オプション情報の受け取りをオプトインすると、API レスポンスの判定結果に新しいフィールドとレスポンスが追加されます。
| レスポンス フィールド | 値 | 説明 |
|---|---|---|
| アプリアクセス リスクの判定結果 | KNOWN_INSTALLED |
Google Play によってインストールされたか、デバイスのメーカーによってシステム パーティションにプリロードされたアプリです。 |
KNOWN_CAPTURING |
Google Play によってインストールされたアプリ、またはデバイスにプリロードされたアプリのうち、リクエスト元アプリの入出力の読み取りまたはキャプチャに使用できるアプリが実行されています（スクリーン レコーダー アプリなど）。 | |
KNOWN_CONTROLLING |
Google Play によってインストールされたアプリ、またはデバイスにプリロードされたアプリのうち、デバイスやリクエスト元アプリの入出力の制御に使用できるアプリが実行されています（リモコンアプリなど）。 | |
KNOWN_OVERLAYS |
Google Play によってインストールされたアプリ、またはデバイスにプリロードされたアプリが実行されており、リクエスト元のアプリにオーバーレイを表示している可能性があります。 | |
UNKNOWN_INSTALLED |
Google Play によってインストールされた、またはデバイスのメーカーによってシステム パーティションにプリロードされたアプリではない、他のアプリがインストールされています。 | |
UNKNOWN_CAPTURING |
リクエスト元アプリの入出力の読み取りまたはキャプチャに使用できる他のアプリ（Google Play によってインストールされた、またはデバイスにプリロードされたアプリではない）が実行されています（スクリーン レコーダー アプリなど）。 | |
UNKNOWN_CONTROLLING |
デバイスやリクエスト元アプリの入出力の制御に使用できる他のアプリ（Google Play によってインストールされた、またはデバイスにプリロードされたアプリではない）が実行されています（リモコンアプリなど）。 | |
UNKNOWN_OVERLAYS |
リクエスト元のアプリにオーバーレイを表示している可能性のある他のアプリ（Google Play によってインストールされたアプリ、またはデバイスにプリロードされたアプリではない）が実行されています。 | |
| 空（空の値） | 要件が満たされていない場合、アプリアクセス リスクは評価されません。この場合、appAccessRiskVerdict フィールドは空です。次のような原因が考えられます。
|
|
| Play プロテクトの判定結果 | NO_ISSUES |
Play プロテクトはオンになっていますが、デバイスにおいてアプリの問題は検知されませんでした。 |
NO_DATA |
Play プロテクトはオンになっていますが、まだスキャンが実行されていません。デバイスまたは Play ストア アプリが最近リセットされた可能性があります。 | |
POSSIBLE_RISK |
Play プロテクトがオフになっています。 | |
MEDIUM_RISK |
Play プロテクトがオンになっており、有害な可能性があるアプリがデバイスにインストールされていることが検知されました。 | |
HIGH_RISK |
Play プロテクトがオンになっており、危険なアプリがデバイスにインストールされていることが検知されました。 | |
UNEVALUATED |
Play プロテクトの判定結果は評価されませんでした。デバイスの信頼性が十分でないなど、要件が満たされていませんでした。 |
クラシック リクエストの設定を構成する（省略可）
標準 API リクエストのみを行う予定の場合は、このセクションをスキップしてください。
デフォルトでは、Google Play がレスポンスの暗号化を管理します。つまり、バックエンドが Google のサーバーを呼び出して判定を復号します。または、鍵を自分で管理して、安全なサーバー環境内でローカルに復号することもできます。
レスポンスの暗号化を Google に任せる（推奨）
アプリのセキュリティを保護するため、鍵の生成と管理を Google で行えるようにすることをおすすめします。バックエンドが Google Play のサーバーを呼び出してレスポンスを復号し、検証します。
独自の暗号鍵を管理する
独自の安全なサーバー環境内でローカルに復号するには、Google Play Console または Play SDK Console から暗号鍵をダウンロードします。この機能を使用するには、アプリが Google Play で公開されている必要があります。
Google Play Console でレスポンスの暗号化の管理方法を変更する前に、サービスの停止を回避するため、完全性トークンの復号と検証が Google Play のサーバーで行われるようにサーバーが正しく構成されていることを確認してください。
暗号鍵の Google 管理とセルフマネージドを切り替える
- Google Play Console を開き、アプリを選択します。
- [Google Play による保護] に移動します。
- [Play Integrity API] の横にある [管理] をクリックします。
- [クラシック リクエスト] で、[レスポンスの暗号化] の横にある [編集] をクリックします。
セルフマネージド キーに切り替えるには:
- [レスポンスの暗号鍵を自分で管理、ダウンロードする] を選択し、公開鍵をアップロードします。
- [保存] をクリックして、暗号化された鍵を自動的にダウンロードします。
- これらの鍵を使用してローカルで復号するよう、安全なバックエンド サーバーを更新します。
Google が管理する鍵に切り替えるには:
- [レスポンスの暗号化の管理を Google に任せる（推奨）] を選択します。
- [変更を保存] をクリックします。