Google Play App Reviews
Les avis Google Play sont des évaluations publiques d’applications qui associent un commentaire rédigé et une note en étoiles à l’identité de l’auteur, à la date de publication et à la référence de l’application évaluée. Ces enregistrements servent à étudier les retours des utilisateurs, à comparer des notes, à surveiller des versions et à constituer des jeux d’avis reliés à leur source.
Fonctionnalités de la Google Play App Reviews API
- Entrée multi-applicationsAccepte une ou plusieurs URL d’applications play.google.com et répartit le nombre d’avis demandé entre les applications envoyées.
- Contenu et note de l’avisRenvoie le texte et la note numérique de chaque avis disponible dans un enregistrement d’avis cohérent.
- Auteur et contexte temporelConserve avec le retour l’identité de l’auteur, la référence de son profil, la date de publication et la date de collecte lorsqu’elles sont disponibles.
- Traçabilité vers l’application évaluéeRelie les avis normalisés aux identifiants d’application et aux URL publiques disponibles via subject_id et subject_url.
Paramètres de la Google Play App Reviews API
| Paramètres | Obligatoire | Description |
|---|---|---|
urls | Obligatoire | Tableau obligatoire d’une ou plusieurs URL d’applications non vides sur play.google.com ou ses sous-domaines. |
country | Facultatif | Chaîne facultative transmise à la source des avis comme contexte de pays ; omettez-la si aucun contexte de marché n’est nécessaire. |
results_limit | Facultatif | Entier positif facultatif de 1 à 2 000. Il vaut 100 par défaut et plafonne le total des résultats stockés pour toutes les URL envoyées. |
Comment utiliser la Google Play App Reviews API
Envoyez des URL d’applications Google Play, suivez la tâche asynchrone et parcourez les enregistrements normalisés stockés par SocQ.
- Préparez une ou plusieurs URL publiques d’applications dont le nom d’hôte est play.google.com ou l’un de ses sous-domaines.
- Envoyez urls, avec country et results_limit facultatifs, en POST à /v1/google-play/app-reviews, puis conservez le task_id renvoyé.
- Interrogez /v1/tasks/{task_id} jusqu’à ce que la tâche réussisse ou échoue ; n’envoyez pas d’autre tâche pendant l’interrogation.
- Après le succès, lisez data.results.items et renvoyez next_cursor à la route de la tâche tant que has_more vaut 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 trueCas d’usage de la Google Play App Reviews API
- Étude des thèmes de retours : Servez-vous du texte et des notes des avis pour préparer un corpus relié à sa source, destiné au codage qualitatif ou à une analyse de texte en aval.
- Comparaison des notes et des textes : Comparez les commentaires rédigés avec la note numérique associée sur une sélection de pages publiques d’applications.
- Suivi chronologique des avis : Combinez dates de publication et de collecte pour comparer des échantillons d’avis collectés séparément autour des sorties de versions.
- Enrichissement de données liées aux applications : Rattachez les champs d’auteur, de texte, de note et d’horodatage aux fiches d’applications grâce à subject_id et subject_url.
Conseils d’expert pour la Google Play App Reviews API
- Utilisez des URL publiques complètes d’applications sur play.google.com ; les autres hôtes échouent à la validation avant le début de la collecte.
- Avec plusieurs URL, choisissez results_limit comme objectif pour toute la tâche : l’allocation côté source est répartie entre les applications envoyées et le stockage final est plafonné globalement.
- Ne renseignez country que si le contexte de marché compte, et gardez la même valeur d’une collecte à l’autre pour celles que vous comptez comparer.
- Suivez le next_cursor de la réponse de la tâche pour obtenir les enregistrements stockés supplémentaires ; c’est un curseur de résultats SocQ, non un curseur accepté par la source des avis.
- Traitez les champs facultatifs d’auteur, de lien source et de médias comme nullables, au lieu de remplacer les valeurs manquantes par des valeurs par défaut inventées.
API associées
En complément de la Google Play App Reviews API, utilisez ces API lorsque vous avez besoin d’un autre type de données publiques Google Play.
- Google Play App Detail API — Récupérez les informations normalisées d’une fiche publique Google Play à partir d’URL d’applications connues, dont identité, textes de la fiche, développeur, catégorie, indicateurs visibles, prix, médias et contexte de collecte.
- Google Play App Rankings API