アプリ内レビューを統合する（Kotlin または Java）

このガイドでは、Kotlin または Java を使用して、アプリ内レビューをアプリに統合する方法について説明します。ネイティブ コードまたは Unity を使用している場合の統合ガイドは個別に用意されています。

開発環境をセットアップする

In-App Review API は Play Core SDK の一部です。開発環境を設定するには、Play Core ライブラリ ガイドの Java または Kotlin のセクションに記載されている設定手順に従ってください。

ReviewManager を作成する

ReviewManager は、アプリがアプリ内レビューフローを開始するためのインターフェースです。ReviewManagerFactory を使用してインスタンスを作成することにより取得します。

val manager = ReviewManagerFactory.create(context)

ReviewManager manager = ReviewManagerFactory.create(context)

ReviewInfo オブジェクトをリクエストする

アプリ内レビューをリクエストするタイミングのガイダンスに沿って、アプリのユーザーフロー内で、ユーザーにレビューを依頼するのに適切なポイント（ゲームでレベルをクリアしたときなど）を見つけます。アプリがそのポイントに到達したら、ReviewManager インスタンスを使用してリクエスト タスクを作成します。成功すると、アプリ内レビューフローの開始に必要な ReviewInfo オブジェクトが API から返されます。

val request = manager.requestReviewFlow()
request.addOnCompleteListener { task ->
    if (task.isSuccessful) {
        // We got the ReviewInfo object
        val reviewInfo = task.result
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode val reviewErrorCode = (task.getException() as TaskException).errorCode
    }
}

ReviewManager manager = ReviewManagerFactory.create(this);
Task<ReviewInfo> request = manager.requestReviewFlow();
request.addOnCompleteListener(task -> {
    if (task.isSuccessful()) {
        // We can get the ReviewInfo object
        ReviewInfo reviewInfo = task.getResult();
    } else {
        // There was some problem, log or handle the error code.
        @ReviewErrorCode int reviewErrorCode = ((TaskException) task.getException()).getErrorCode();
    }
});

アプリ内レビューフローを開始する

ReviewInfo インスタンスを使用して、アプリ内レビューフローを開始します。アプリ内レビューフローが完了するのを待ってから、通常のユーザーフロー（次のレベルに進むなど）を再開します。

val flow = manager.launchReviewFlow(activity, reviewInfo)
flow.addOnCompleteListener { _ ->
    // The flow has finished. The API does not indicate whether the user
    // reviewed or not, or even whether the review dialog was shown. Thus, no
    // matter the result, we continue our app flow.
}

Task<Void> flow = manager.launchReviewFlow(activity, reviewInfo);
flow.addOnCompleteListener(task -> {
    // The flow has finished. The API does not indicate whether the user
    // reviewed or not, or even whether the review dialog was shown. Thus, no
    // matter the result, we continue our app flow.
});

次のステップ

アプリのアプリ内レビューフローをテストして、統合が正しく機能していることを検証します。