カードとカードの背景を最上位レイヤに置く。カードが表示されたら、プログラムでカードを削除しないでください。カードの削除は、ユーザーの明示的な操作、または Play ストアの内部メカニズムに基づいて自動的に行われます。
割り当て
優れたユーザー エクスペリエンスを提供するため、Google Play では、ある一定期間中レビュー ダイアログをユーザーに表示する回数に対して上限を設けています。この上限のため、短期間(たとえば 1 か月未満)に launchReviewFlow メソッドを複数回呼び出すと、ダイアログが表示されないことがあります。
表示回数の上限は変更される場合があります。そのため、独自のロジックを適用し、可能な限り最適なタイミングでレビューをリクエストすることが重要です。たとえば、API をトリガーするよう「行動を促す」オプション(ボタンなど)を設けないでください。ユーザーの表示回数がすでに上限に達していてフローが表示されず、ユーザー エクスペリエンスが破綻する可能性があるためです。このユースケースでは、代わりにユーザーを Play ストアにリダイレクトします。
Play アプリ内レビュー ライブラリにアクセスするか、これを使用すると、Play Core ソフトウェア開発キット利用規約に同意したことになります。適用されるすべての利用規約とポリシーを読んで理解したうえで、ライブラリにアクセスしてください。
データ セーフティ
Play Core ライブラリは、Google Play ストアに対するアプリのランタイム インターフェースです。そのため、アプリで Play Core を使用すると、Play ストア独自のプロセスが実行され、Google Play 利用規約に則ってデータが処理されます。ここでは、Play Core ライブラリがデータを処理して、アプリからの特定のリクエストを処理する方法について説明します。
アプリ内レビュー
使用量について収集されたデータ
ユーザーが入力したデータ(評価と自由形式のレビュー)
データ収集の目的
収集されたデータは、Play ストアでレビューを書き込むために使用されます。
データの暗号化
データは暗号化されています。
データの共有
収集されたデータは、Google Play ストアでの公開レビューの際に使用されます。また、アプリがクローズド テスト トラックにある場合、収集されたデータはアプリ デベロッパーと非公開で共有されます。
データの削除
ユーザーは、Google Play ストア アカウントまたは Google アカウントによるレビューを削除できます。
Google はできる限り透明性を確保することを心掛けていますが、アプリによるデータの収集および共有とアプリのセキュリティ対策に関して Google Play のデータ セーフティ セクションのフォームにどのように入力するかを決定する責任は、デベロッパーのみにあります。
[null,null,["最終更新日 2025-08-08 UTC。"],[],[],null,["# Google Play In-App Reviews API\n\nThe Google Play In-App Review API lets you prompt users to submit Play Store\nratings and reviews without the inconvenience of leaving your app or game.\n\nGenerally, the in-app review flow (see figure 1) can be triggered at any time\nthroughout the user journey of your app. During the flow, the user has the\nability to rate your app using the 1 to 5 star system and to add an optional\ncomment. Once submitted, the review is sent to the Play Store and eventually\ndisplayed.\n| **Note:** To protect user privacy and avoid API misuse, there are strict guidelines that your app should follow about [when to request in-app reviews](#when-to-request) and the [design of the review prompt](#design-guidelines).\n\n\n**Figure 1.** In-app review flow for a user\n\n\u003cbr /\u003e\n\nDevice requirements\n-------------------\n\nIn-app reviews only work on the following devices:\n\n- Android devices (phones, tablets, and TVs with Google TV) running Android 5.0 (API level 21) or higher that have the Google Play Store installed.\n- ChromeOS devices that have the Google Play Store installed.\n\nPlay Core library requirements\n------------------------------\n\nTo integrate in-app reviews in your app, your app must use version 1.8.0 or\nhigher of the [Play Core library](/guide/playcore).\n\nWhen to request an in-app review\n--------------------------------\n\nFollow these guidelines to help you decide when to request in-app reviews from\nusers:\n\n- Trigger the in-app review flow after a user has experienced enough of your app or game to provide useful feedback.\n- Don't prompt the user excessively for a review. This approach helps minimize user frustration and limit API usage (see the [section on quotas](#quotas)).\n- Your app shouldn't ask the user any questions before or while presenting the rating button or card, including questions about their opinion (such as \"Do you like the app?\") or predictive questions (such as \"Would you rate this app 5 stars\").\n\nDesign guidelines\n-----------------\n\nFollow these guidelines as you determine how to integrate in-app reviews in your\napp:\n\n- Surface the card as-is, without tampering or modifying the existing design in any way, including size, opacity, shape, or other properties.\n- Don't add any overlay on top of the card or around the card.\n- The card and the card's background should be on the topmost layer. Once the card has surfaced, don't programmatically remove the card. The card is removed automatically based on either the user's explicit action, or an internal Play Store mechanism.\n\nQuotas\n------\n\nTo provide a great user experience, Google Play enforces a time-bound quota on\nhow often a user can be shown the review dialog. Because of this quota, calling\nthe `launchReviewFlow` method more than once during a short period of time (for\nexample, less than a month) might not always display a dialog.\n| **Note:** The specific value of the quota is an implementation detail, and it can be changed by Google Play without any notice.\n\nBecause the quota is subject to change, it's important to apply your own logic\nand target the best possible moment to request a review. For example, **you\nshould not have a call-to-action option (such as a button) to trigger the API**,\nas a user might have already hit their quota and the flow won't be shown,\npresenting a broken experience to the user. For this use case, redirect the user\nto the Play Store instead.\n\nIntegrate in-app reviews in your app\n------------------------------------\n\nLearn how to integrate in-app reviews in your app, depending on your development\nenvironment:\n\n- [Kotlin or Java](/guide/playcore/in-app-review/kotlin-java)\n- [Native (C++)](/guide/playcore/in-app-review/native)\n- [Unity](/guide/playcore/in-app-review/unity)\n- [Unreal Engine](/guide/playcore/in-app-review/unreal-engine)\n\nTerms of service and data safety\n--------------------------------\n\nBy accessing or using the Play In-App Reviews Library, you agree to the [Play\nCore Software Development Kit Terms of Service](/guide/playcore#license). Read and understand all\napplicable terms and policies before accessing the library.\n\nData Safety\n-----------\n\nThe Play Core libraries are your app's runtime interface with the Google Play\nStore. As such, when you use Play Core in your app, the Play Store runs its own\nprocesses, which include handling data as governed by the [Google Play Terms of\nService](https://play.google.com/about/play-terms/index.html). The following information describes how the Play Core\nlibraries handle data to process specific requests from your app.\n\n### In-app Reviews\n\n|----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| Data collected on usage | User-entered data (rating and free-text review) |\n| Purpose of data collection | The data collected is used to leave a review on the Play Store. |\n| Data encryption | Data is encrypted. |\n| Data sharing | The data collected is used in a public review on the Play Store or, if the app is in a closed test track, the data collected is shared privately with the app developer. |\n| Data deletion | Users can delete their reviews in their Google Play Store account or Google Account. |\n\nWhile we aim to be as transparent as possible, you are solely responsible for\ndeciding how to respond to Google Play's data safety section form regarding your\napp's user data collection, sharing, and security practices."]]