Google Play App Reviews
Le recensioni delle app su Google Play sono valutazioni pubbliche dello store che abbinano feedback scritto e valutazioni a stelle all’identità di chi recensisce, all’orario di pubblicazione e al riferimento all’app recensita. Questi record supportano ricerche sul feedback, confronti tra valutazioni, monitoraggio dei rilasci e dataset di recensioni collegati alla fonte.
Funzionalità della Google Play App Reviews API
- Input di URL di più appAccetta uno o più URL di app di play.google.com e ripartisce il numero di recensioni richiesto tra le app inviate.
- Contenuto e valutazione della recensioneRestituisce il testo e la valutazione numerica di ogni recensione disponibile in un record di recensione coerente.
- Contesto di autore e orarioConserva insieme al feedback l’identità disponibile di chi ha recensito, il riferimento al profilo, l’orario di pubblicazione e quello di raccolta.
- Tracciabilità dell’app recensitaCollega le recensioni normalizzate agli identificatori disponibili delle app e ai loro URL pubblici tramite subject_id e subject_url.
Parametri della Google Play App Reviews API
| Parametri | Obbligatorio | Descrizione |
|---|---|---|
urls | Obbligatorio | Array obbligatorio di uno o più URL di app non vuoti su play.google.com o sui suoi sottodomini. |
country | Facoltativo | Stringa facoltativa passata alla fonte delle recensioni come contesto del paese; omettila quando non serve alcun contesto di mercato. |
results_limit | Facoltativo | Intero positivo facoltativo da 1 a 2.000. Il valore predefinito è 100 e limita il totale dei risultati salvati su tutti gli URL inviati. |
Come usare la Google Play App Reviews API
Invia gli URL delle app di Google Play, segui l’attività asincrona e scorri i record normalizzati salvati da SocQ.
- Prepara uno o più URL pubblici di app il cui hostname è play.google.com o uno dei suoi sottodomini.
- Invia con POST urls, con country e results_limit facoltativi, a /v1/google-play/app-reviews, poi salva il task_id restituito.
- Interroga /v1/tasks/{task_id} finché l’attività non termina con successo o con un errore; non inviare un’altra attività mentre interroghi.
- Dopo il successo leggi data.results.items e restituisci next_cursor alla route dell’attività finché 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 trueCasi d’uso della Google Play App Reviews API
- Ricerca sui temi del feedback: Usa testo e valutazioni delle recensioni per preparare un corpus collegato alla fonte, da usare per la codifica qualitativa o per analisi del testo a valle.
- Confronto tra valutazioni e testo: Confronta il feedback scritto con la relativa valutazione numerica su pagine pubbliche di app selezionate.
- Monitoraggio della cronologia delle recensioni: Combina gli orari di pubblicazione e di raccolta per confrontare campioni di recensioni raccolti separatamente in prossimità dei rilasci di un prodotto.
- Arricchimento di dataset collegati alle app: Associa ai record delle app i campi di autore, testo, valutazione e timestamp tramite subject_id e subject_url.
Consigli degli esperti per la Google Play App Reviews API
- Usa URL pubblici e completi di app su play.google.com; altri host non superano la convalida dell’input prima dell’inizio della raccolta.
- Quando invii più URL, scegli results_limit come obiettivo valido per l’intera attività, perché l’allocazione della fonte viene divisa tra gli input delle app e il salvataggio finale ha un limite globale.
- Imposta country solo quando il contesto di mercato conta e mantieni lo stesso valore nelle raccolte ripetute che intendi confrontare.
- Segui il next_cursor della risposta dell’attività per ottenere altri record salvati; è un cursore dei risultati di SocQ, non un cursore accettato dalla fonte delle recensioni.
- Considera nullable i campi facoltativi di autore, link di origine e media, invece di sostituire i valori mancanti con valori predefiniti inventati.
API correlate
Oltre alla Google Play App Reviews API, usa queste API quando ti serve un altro tipo di dati pubblici di Google Play.
- Google Play App Detail API — Recupera i dettagli pubblici normalizzati di una scheda di Google Play da URL di app noti, tra cui identità, testi dello store, sviluppatore, categoria, metriche visibili, prezzo, media e contesto della raccolta.
- Google Play App Rankings API