Google Play App Reviews
Отзывы о приложениях Google Play — это публичные оценки в магазине приложений, в которых письменный отзыв и оценка в звездах связаны с данными автора, временем публикации и ссылкой на оцениваемое приложение. Такие записи помогают исследовать обратную связь, сравнивать оценки, отслеживать реакцию на релизы и строить датасеты отзывов с привязкой к источнику.
Возможности Google Play App Reviews API
- URL нескольких приложений на входеПринимает один или несколько URL приложений на play.google.com и распределяет запрошенное число отзывов между отправленными приложениями.
- Содержание отзыва и оценкаВозвращает текст и числовую оценку каждого доступного отзыва в единообразной записи отзыва.
- Контекст автора и времениСохраняет вместе с отзывом доступные данные автора, ссылку на профиль, время публикации и время сбора.
- Привязка к оцениваемому приложениюСвязывает нормализованные отзывы с доступными идентификаторами приложений и публичными URL приложений через subject_id и subject_url.
Параметры Google Play App Reviews API
| Параметры | Обязательный | Описание |
|---|---|---|
urls | Обязательный | Обязательный массив из одного или нескольких непустых URL приложений на play.google.com или его поддоменах. |
country | Необязательный | Необязательная строка, передаваемая источнику отзывов как контекст страны; не указывайте ее, если контекст рынка не нужен. |
results_limit | Необязательный | Необязательное положительное целое число от 1 до 2 000. По умолчанию 100; ограничивает общее число сохраненных результатов по всем отправленным URL. |
Как использовать Google Play App Reviews API
Отправьте URL приложений Google Play, отслеживайте асинхронную задачу и постранично читайте нормализованные записи, сохраненные SocQ.
- Подготовьте один или несколько публичных URL приложений, у которых имя хоста — play.google.com или один из его поддоменов.
- Отправьте urls с необязательными country и results_limit методом POST на /v1/google-play/app-reviews и сохраните возвращенный task_id.
- Опрашивайте /v1/tasks/{task_id}, пока задача не завершится успешно или с ошибкой; не отправляйте новую задачу во время опроса.
- После успешного завершения читайте data.results.items и передавайте next_cursor обратно в маршрут задачи, пока has_more равно true.
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
- Используйте полные публичные URL приложений на play.google.com; другие хосты не проходят проверку входных данных еще до начала сбора.
- При отправке нескольких URL выбирайте results_limit как цель для всей задачи: запросы к источнику делятся между приложениями, а итоговое сохранение ограничено глобально.
- Указывайте country, только если важен контекст рынка, и сохраняйте одно и то же значение в повторных сборах, которые собираетесь сравнивать.
- Для получения следующих сохраненных записей используйте next_cursor из ответа задачи; это курсор результатов SocQ, а не курсор, который принимает источник отзывов.
- Считайте необязательные поля автора, ссылки на источник и медиафайлов допускающими null и не заменяйте отсутствующие значения выдуманными.
Связанные API
Помимо Google Play App Reviews API, используйте эти API, когда нужен другой тип публичных данных Google Play.
- Google Play App Detail API — Получайте нормализованные публичные данные карточки Google Play по известным URL приложений: название, описание в магазине, разработчик, категория, видимые метрики, цена, медиа и контекст сбора.
- Google Play App Rankings API