Google Play App Reviews
Las reseñas de apps de Google Play son valoraciones públicas de la tienda de aplicaciones que combinan comentarios escritos y calificaciones por estrellas con la identidad de quien reseña, el momento de publicación y la referencia de la app reseñada. Estos registros sirven para investigar opiniones, comparar calificaciones, monitorear lanzamientos y armar conjuntos de datos de reseñas vinculados a su fuente.
Funcionalidades de la Google Play App Reviews API
- Entrada de URL de varias appsAcepta una o más URL de apps de play.google.com y distribuye la cantidad de reseñas solicitada entre las apps enviadas.
- Contenido y calificación de la reseñaDevuelve el texto y la calificación numérica de cada reseña disponible en un registro de reseña consistente.
- Contexto de quien reseña y del momentoConserva la identidad disponible de quien reseña, la referencia de su perfil, el momento de publicación y el momento de recopilación junto con la opinión.
- Trazabilidad de la app reseñadaVincula las reseñas normalizadas con los identificadores de app y las URL públicas de apps disponibles mediante subject_id y subject_url.
Parámetros de la Google Play App Reviews API
| Parámetros | Obligatorio | Descripción |
|---|---|---|
urls | Obligatorio | Lista obligatoria de una o más URL de apps no vacías en play.google.com o sus subdominios. |
country | Opcional | Cadena opcional que se pasa a la fuente de reseñas como contexto de país; omítala cuando no se necesite contexto de mercado. |
results_limit | Opcional | Entero positivo opcional de 1 a 2,000. Su valor predeterminado es 100 y limita el total de resultados almacenados entre todas las URL enviadas. |
Cómo usar la Google Play App Reviews API
Envíe URL de apps de Google Play, siga la tarea asíncrona y recorra por páginas los registros normalizados que almacena SocQ.
- Prepare una o más URL públicas de apps cuyo nombre de host sea play.google.com o uno de sus subdominios.
- Envíe urls por POST con un country y un results_limit opcionales a /v1/google-play/app-reviews y guarde el task_id devuelto.
- Consulte /v1/tasks/{task_id} hasta que la tarea se complete con éxito o falle; no envíe otra tarea mientras consulta.
- Tras el éxito, lea data.results.items y devuelva next_cursor a la ruta de la tarea mientras has_more sea 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 trueCasos de uso de la Google Play App Reviews API
- Investigación de temas de opinión: Use el texto y las calificaciones de las reseñas para preparar un corpus vinculado a su fuente, destinado a codificación cualitativa o a análisis de texto posterior.
- Comparación de calificaciones y texto: Compare las opiniones escritas con la calificación numérica asociada en páginas públicas de apps seleccionadas.
- Monitoreo de la línea de tiempo de reseñas: Combine los momentos de publicación y de recopilación para comparar muestras de reseñas recopiladas por separado en torno a los lanzamientos de producto.
- Enriquecimiento de conjuntos de datos vinculados a apps: Agregue campos de autor, texto, calificación y marca de tiempo a los registros de apps mediante subject_id y subject_url.
Consejos de expertos para la Google Play App Reviews API
- Use URL públicas completas de apps en play.google.com; otros hosts no pasan la validación de entrada antes de que comience la recopilación.
- Al enviar varias URL, elija results_limit como un objetivo para toda la tarea, porque la asignación en la fuente se reparte entre las apps de entrada y el almacenamiento final tiene un tope global.
- Defina country solo cuando el contexto de mercado importe, y mantenga el mismo valor en las recopilaciones repetidas que pretenda comparar.
- Siga el next_cursor de la respuesta de la tarea para obtener más registros almacenados; es un cursor de resultados de SocQ, no un cursor que acepte la fuente de reseñas.
- Trate los campos opcionales de quien reseña, de enlaces de origen y de contenido multimedia como valores que pueden ser nulos, en lugar de reemplazar los valores ausentes con valores predeterminados inventados.
APIs relacionadas
Además de la Google Play App Reviews API, use estas APIs cuando necesite otro tipo de datos públicos de Google Play.
- Google Play App Detail API — Obtiene detalles públicos normalizados de fichas de Google Play desde URLs conocidas de apps, incluyendo identidad, textos de la tienda, desarrollador, categoría, métricas visibles, precio, contenido multimedia y contexto de recolección.
- Google Play App Rankings API