Google Play App Reviews
Google-Play-App-Bewertungen sind öffentliche Beurteilungen im App-Store, die geschriebenes Feedback und Sternebewertungen mit der Identität der bewertenden Person, der Veröffentlichungszeit und dem Verweis auf die bewertete App verbinden. Diese Datensätze eignen sich für Feedback-Recherche, den Vergleich von Bewertungen, die Beobachtung von Releases und Bewertungsdatensätze mit Quelllink.
Funktionen der Google Play App Reviews API
- Eingabe mehrerer App-URLsNimmt eine oder mehrere App-URLs auf play.google.com entgegen und verteilt die angeforderte Zahl der Bewertungen auf die übergebenen Apps.
- Bewertungsinhalt und SternebewertungLiefert Text und numerische Sternebewertung jeder verfügbaren Bewertung in einem einheitlichen Bewertungsdatensatz.
- Kontext zu Bewertenden und ZeitBehält verfügbare Identität der bewertenden Person, Profilverweis, Veröffentlichungszeit und Erfassungszeit zusammen mit dem Feedback bei.
- Rückverfolgbarkeit zur bewerteten AppVerknüpft normalisierte Bewertungen über subject_id und subject_url mit verfügbaren App-Kennungen und öffentlichen App-URLs.
Parameter der Google Play App Reviews API
| Parameter | Erforderlich | Beschreibung |
|---|---|---|
urls | Erforderlich | Erforderliches Array mit einer oder mehreren nicht leeren App-URLs auf play.google.com oder dessen Subdomains. |
country | Optional | Optionale Zeichenfolge, die als Länderkontext an die Bewertungsquelle übergeben wird; lassen Sie sie weg, wenn kein Marktkontext nötig ist. |
results_limit | Optional | Optionale positive ganze Zahl von 1 bis 2.000. Der Standardwert ist 100; sie begrenzt die Gesamtzahl der gespeicherten Ergebnisse über alle übergebenen URLs hinweg. |
So verwenden Sie die Google Play App Reviews API
Senden Sie App-URLs von Google Play, verfolgen Sie die asynchrone Aufgabe und blättern Sie durch die von SocQ gespeicherten normalisierten Datensätze.
- Bereiten Sie eine oder mehrere öffentliche App-URLs vor, deren Hostname play.google.com oder eine seiner Subdomains ist.
- Senden Sie urls mit optionalem country und results_limit per POST an /v1/google-play/app-reviews und speichern Sie die zurückgegebene task_id.
- Fragen Sie /v1/tasks/{task_id} ab, bis die Aufgabe erfolgreich abgeschlossen wird oder fehlschlägt; senden Sie während der Abfrage keine weitere Aufgabe.
- Lesen Sie nach dem Erfolg data.results.items und übergeben Sie next_cursor an die Aufgabenroute zurück, solange has_more den Wert true hat.
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 trueAnwendungsfälle der Google Play App Reviews API
- Recherche zu Feedback-Themen: Nutzen Sie Bewertungstext und Sternebewertungen, um ein Korpus mit Quelllink für qualitative Kodierung oder nachgelagerte Textanalyse vorzubereiten.
- Vergleich von Sternebewertung und Text: Vergleichen Sie geschriebenes Feedback mit der zugehörigen numerischen Sternebewertung über ausgewählte öffentliche App-Seiten hinweg.
- Beobachtung des Bewertungsverlaufs: Kombinieren Sie Veröffentlichungs- und Erfassungszeiten, um getrennt erfasste Stichproben von Bewertungen rund um Produkt-Releases zu vergleichen.
- Anreicherung von Datensätzen mit App-Bezug: Hängen Sie Felder zu Bewertenden, Text, Sternebewertung und Zeitstempel über subject_id und subject_url an App-Datensätze an.
Profi-Tipps zur Google Play App Reviews API
- Verwenden Sie vollständige öffentliche App-URLs auf play.google.com; andere Hosts scheitern an der Eingabevalidierung, bevor die Erfassung beginnt.
- Wählen Sie bei mehreren URLs results_limit als Ziel für die gesamte Aufgabe, denn die Zuteilung bei der Quelle wird auf die App-Eingaben aufgeteilt und die endgültige Speicherung global begrenzt.
- Setzen Sie country nur, wenn der Marktkontext wichtig ist, und behalten Sie denselben Wert in wiederholten Erfassungen bei, die Sie vergleichen möchten.
- Folgen Sie dem next_cursor der Aufgabenantwort für weitere gespeicherte Datensätze; er ist ein Ergebnis-Cursor von SocQ und kein Cursor, den die Bewertungsquelle akzeptiert.
- Behandeln Sie optionale Felder zu Bewertenden, Quelllinks und Medien als nullable, statt fehlende Werte durch erfundene Standardwerte zu ersetzen.
Verwandte APIs
Ergänzend zur Google Play App Reviews API nutzen Sie diese APIs, wenn Sie eine andere Art öffentlicher Google Play-Daten benötigen.
- Google Play App Detail API — Normalisierte öffentliche Details von Google-Play-Einträgen aus bekannten App-URLs abrufen, darunter Identität, Store-Texte, Entwickler, Kategorie, sichtbare Kennzahlen, Preis, Medien und Erfassungskontext.
- Google Play App Rankings API