google-play/
app-reviews

play.google.comのアプリURLから公開Google Playアプリレビューを収集し、任意で国を指定して、レビュー本文、投稿者、評価、タイムスタンプ、アプリ参照情報を正規化レコードとして返します。

Google Play App Reviews API

アプリURLの一括送信
レビュー本文と評価
国の指定
結果1件あたり0.15クレジット
準備完了
準備完了

パラメータを入力してリクエストを送信してください。タスクのステータスと正規化された結果がここに表示されます。

README

SocQ 編集 · 更新

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に保存された正規化レコードをページ送りで読み取ります。

  1. ホスト名がplay.google.comまたはそのサブドメインである公開アプリURLを1つ以上用意します。
  2. urls と任意の country、results_limit を /v1/google-play/app-reviews に POST し、返された task_id を保存します。
  3. タスクが成功または失敗するまで /v1/tasks/{task_id} をポーリングします。ポーリング中に別のタスクを送信しないでください。
  4. 成功したら 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 true

Google 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 になりうるものとして扱い、欠損値を独自のデフォルト値で埋めないでください。

Google Play App Reviews API 以外に別の種類の公開Google Playデータが必要な場合は、これらのAPIをご利用ください。

  • Google Play App Detail API — 既知のアプリURLから、Google Playの公開掲載情報を正規化して取得します。アプリ情報、ストア掲載文、デベロッパー、カテゴリ、表示中の指標、価格、メディア、取得情報を含みます。
  • Google Play App Rankings API

他のプラットフォームを見る

Google Playのデータを、対応する他のソーシャルプラットフォームの公開データと組み合わせられます。

Google Play App Reviews API — よくある質問

Google Play App Reviews APIは、送信した1つ以上のGoogle PlayアプリURLから、任意で国を指定して公開アプリレビューを収集するためのプログラムインターフェースです。正規化されたレビュー本文、投稿者の詳細、評価、投稿日時、メディア、対象アプリの参照情報を返します。

urls は、ホスト名がplay.google.comまたはそのサブドメインである空でないURLの必須配列です。country は取得元へのリクエストにそのまま渡される任意の文字列で、省略できます。

results_limit のデフォルトは100で、1〜2,000の整数を指定できます。取得元へのリクエストでは指定件数が送信したURL間で配分され、SocQはタスクの保存結果の総数を指定した上限に制限します。

正規化レコードには、レビューID、取得元URL、本文、投稿者の情報、数値評価、投稿日時と取得日時、アプリ識別子、アプリURL、メディア参照が含まれる場合があります。公開結果に含まれない任意フィールドは null または空のままになります。

呼び出し側から取得元のカーソルを指定することはできません。非同期タスクが成功した後、next_cursor と has_more を使って、SocQにすでに保存されている結果行をページ送りします。

results_limit を省略した場合、タスクは100件として見積もられ、保存された結果1件につき0.15 SocQクレジットがかかります。最終的な請求は実際の結果件数に基づき、成功して結果が0件だった場合は基本料金0クレジットで精算されます。