Google Play App Reviews
Google Play 앱 리뷰는 작성된 의견과 별점을 작성자 정보, 게시 시각, 리뷰 대상 앱 참조 정보와 함께 담은 공개 앱스토어 평가입니다. 이러한 레코드는 의견 조사, 평점 비교, 릴리스 모니터링, 출처가 연결된 리뷰 데이터셋 구축에 활용할 수 있습니다.
Google Play App Reviews API 주요 기능
- 여러 앱 URL 입력play.google.com 앱 URL을 하나 이상 받아, 요청한 리뷰 수를 제출한 앱들에 나누어 할당합니다.
- 리뷰 내용과 평점확인 가능한 리뷰마다 텍스트와 숫자 평점을 일관된 리뷰 레코드로 반환합니다.
- 작성자 및 시간 정보확인 가능한 작성자 식별 정보, 프로필 참조 정보, 게시 시각, 수집 시각을 피드백과 함께 보존합니다.
- 리뷰 대상 앱 추적subject_id와 subject_url을 통해 정규화된 리뷰를 확인 가능한 앱 식별자와 공개 앱 URL에 연결합니다.
Google Play App Reviews API 매개변수
| 매개변수 | 필수 | 설명 |
|---|---|---|
urls | 필수 | play.google.com 또는 그 서브도메인에 있는, 비어 있지 않은 앱 URL을 하나 이상 담은 배열로, 필수 값입니다. |
country | 선택 | 국가 정보로 리뷰 원본에 전달되는 문자열이며, 선택 값입니다. 시장 정보가 필요하지 않으면 생략하세요. |
results_limit | 선택 | 1 이상 2,000 이하의 양의 정수이며, 선택 값입니다. 기본값은 100이고, 제출한 모든 URL에 걸쳐 저장되는 전체 결과 수의 상한을 정합니다. |
Google Play App Reviews API 사용 방법
Google Play 앱 URL을 제출하고, 비동기 작업을 추적한 뒤, SocQ에 저장된 정규화 레코드를 페이지 단위로 읽습니다.
- 호스트 이름이 play.google.com이거나 그 서브도메인인 공개 앱 URL을 하나 이상 준비합니다.
- 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