Google Play App Reviews
Google Playアプリレビューは、文章によるフィードバックと星評価を、レビュー投稿者の情報、投稿日時、対象アプリの参照情報と組み合わせた公開アプリストア評価です。これらのレコードは、フィードバック調査、評価の比較、リリース後のモニタリング、取得元にひもづいたレビューデータセットの構築に活用できます。
Google Play App Reviews API の主な機能
- 複数アプリのURL入力1つ以上のplay.google.comアプリURLを受け付け、指定したレビュー件数を送信したアプリ間で配分します。
- レビュー本文と評価取得できた各レビューの本文と数値評価を、一貫したレビューレコードとして返します。
- 投稿者と日時の情報取得できたレビュー投稿者の情報、プロフィール参照、投稿日時、取得日時をフィードバックとあわせて保持します。
- 対象アプリへのトレーサビリティsubject_id と subject_url を通じて、正規化されたレビューを取得できたアプリ識別子と公開アプリURLにひもづけます。
Google Play App Reviews API のパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
urls | 必須 | 必須。play.google.comまたはそのサブドメイン上にある、空でないアプリURLを1つ以上含む配列です。 |
country | 任意 | 任意。国の指定としてレビュー取得元に渡される文字列です。マーケットの指定が不要な場合は省略してください。 |
results_limit | 任意 | 任意。1〜2,000の正の整数です。デフォルトは100で、送信したすべてのURLを合わせた保存結果の総数の上限となります。 |
Google Play App Reviews API の使い方
Google PlayアプリURLを送信して非同期タスクを追跡し、SocQに保存された正規化レコードをページ送りで読み取ります。
- ホスト名がplay.google.comまたはそのサブドメインである公開アプリURLを1つ以上用意します。
- urls と任意の country、results_limit を /v1/google-play/app-reviews に POST し、返された task_id を保存します。
- タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。ポーリング中に別のタスクを送信しないでください。
- 成功したら data.results.items を読み取り、has_more が true の間は next_cursor をタスクのルートに渡して続きを取得します。
curl -X POST "https://api.socq.ai/v1/google-play/app-reviews" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://play.google.com/store/apps/details?id=com.example.notes"],"country":"US","results_limit":100}'
# Poll GET /v1/tasks/{task_id}
# Read data.results.items and follow next_cursor while has_more is trueGoogle Play App Reviews API の主なユースケース
- フィードバックのテーマ調査: レビュー本文と評価を使って、定性的なコーディングや下流のテキスト分析に使える、取得元にひもづいたコーパスを用意します。
- 評価と本文の比較: 選定した公開アプリページについて、文章によるフィードバックと対応する数値評価を比較します。
- レビューの時系列モニタリング: 投稿日時と取得日時を組み合わせ、製品リリース前後に別々に収集したレビューサンプルを比較します。
- アプリにひもづくデータセットの補完: subject_id と subject_url を使って、投稿者、本文、評価、タイムスタンプの各フィールドをアプリレコードに付与します。
Google Play App Reviews API 活用のヒント
- play.google.com上の完全な公開アプリURLを使用してください。その他のホストは、収集開始前の入力検証でエラーになります。
- 複数のURLを送信する場合、取得元での件数はアプリ入力間で配分され、最終的な保存件数は全体で上限が設けられるため、results_limit はタスク全体の目標件数として設定してください。
- country はマーケットの指定が重要な場合にのみ設定し、比較する予定の繰り返し収集では同じ値を使い続けてください。
- 追加の保存済みレコードを取得するには、タスクレスポンスの next_cursor を使用してください。これはSocQの結果カーソルであり、レビュー取得元が受け付けるカーソルではありません。
- 任意の投稿者、取得元リンク、メディアの各フィールドは null になりうるものとして扱い、欠損値を独自のデフォルト値で埋めないでください。
関連API
Google Play App Reviews API 以外に別の種類の公開Google Playデータが必要な場合は、これらのAPIをご利用ください。
- Google Play App Detail API — 既知のアプリURLから、Google Playの公開掲載情報を正規化して取得します。アプリ情報、ストア掲載文、デベロッパー、カテゴリ、表示中の指標、価格、メディア、取得情報を含みます。
- Google Play App Rankings API