Panoramica
Google Play Console fornisce una suite di API di servizi web basate su REST che ti consentono di eseguire funzioni di pubblicazione, generazione di report e altre funzioni di gestione delle app direttamente per la tua app.
Non tutti gli sviluppatori devono utilizzare queste API: nella maggior parte dei casi, puoi continuare a gestire le tue app direttamente tramite Google Play Console. Tuttavia, se devi gestire un numero elevato di APK o se devi monitorare gli acquisti e gli abbonamenti degli utenti, queste API potrebbero esserti utili.
Che cosa è incluso
Le API Google Play Developer ti consentono di concentrarti sulla progettazione e sullo sviluppo della tua app e allo stesso tempo dedicare meno tempo e impegno alla gestione delle release, anche in caso di espansione in nuovi mercati.
Google Play Console include una suite di API che puoi utilizzare per gestire la tua app:
- L'API Publishing consente di caricare e pubblicare app, nonché di eseguire altre attività correlate alla pubblicazione.
- L'API Subscriptions and In-App Purchases ti consente di gestire gli acquisti in-app e gli abbonamenti. In precedenza, questa API era nota come "API Purchase Status".
- L'API di reporting ti consente di recuperare informazioni sulla qualità della tua app da Android vitals.
- L'API Reply to Reviews ti consente di recuperare le recensioni sulla tua app e rispondere.
- L'APIPermissions consente di automatizzare la gestione delle autorizzazioni all'interno di Play Console.
- L'API Play Games Services Management ti consente di emettere chiamate REST per controllare in modo programmatico i metadati alla base delle funzionalità dei servizi per i giochi di Google Play.
- L'API Voided Purchases fornisce un elenco di ordini associati ad acquisti annullati dall'utente.
Per iniziare
Per iniziare a utilizzare le API Google Play Developer, consulta la documentazione per iniziare.
API Publishing
L'API Publishing ti consente di automatizzare le attività frequenti relative alla distribuzione delle app. In questo modo vengono fornite funzioni simili a quelle disponibili per uno sviluppatore tramite Play Console, ad esempio:
- Caricare nuove versioni di un'app
- Rilascio delle app mediante l'assegnazione di APK a vari canali (alpha, beta, implementazione graduale o produzione)
- Creare e modificare le schede del Google Play Store, inclusi testo ed elementi grafici localizzati e screenshot per più dispositivi
Queste attività vengono eseguite utilizzando la funzionalità di modifiche, che adotta un approccio transazionale per apportare modifiche. In questo modo puoi raggruppare più modifiche in un'unica modifica alla bozza, quindi eseguire il commit delle modifiche tutte in una volta. Nessuna delle modifiche avrà effetto finché non viene confermata la modifica.
Best practice
- Limita il numero di aggiornamenti delle app. Non pubblicare aggiornamenti alpha o beta più di una volta al giorno (le app di produzione devono essere aggiornate anche meno spesso di così). Ogni aggiornamento costa agli utenti tempo ed eventualmente prezzo. Se esegui gli aggiornamenti troppo di frequente, gli utenti potrebbero iniziare a ignorare gli aggiornamenti o persino a disinstallare il prodotto.
API Subscriptions and In-App Purchases
L'API Subscriptions and In-App Purchases
ti consente di gestire il catalogo
di prodotti in-app e abbonamenti della tua app. Inoltre, con l'API Subscriptions and In-App Purchases, puoi recuperare rapidamente i dettagli di qualsiasi acquisto utilizzando una richiesta GET standard.
Nella richiesta devi fornire informazioni sull'acquisto: nome del pacchetto dell'app, ID acquisto o abbonamento e token di acquisto. Il server risponde con un oggetto JSON che descrive i dettagli di acquisto associati, lo stato dell'ordine, il payload dello sviluppatore e altre informazioni.
Puoi utilizzare questa API in diversi modi, ad esempio per generare report e riconciliare singoli ordini e per verificare gli acquisti e le scadenze degli abbonamenti. Puoi utilizzare l'API anche per avere informazioni sugli ordini annullati e confermare se i prodotti in-app sono stati consumati, incluso se sono stati consumati prima dell'annullamento.
Best practice
- Archivia le informazioni dell'abbonamento sul tuo server per evitare di effettuare chiamate API inutili. Quando la tua app deve verificare un abbonamento, devi basarti sulle informazioni memorizzate nella cache sul server anziché ripetere la chiamata API a Google.
- Esistono due scenari in cui il tuo server sicuro deve utilizzare l'API Google Play Developer per ricevere informazioni sull'abbonamento:
- Il server riceve un nuovo token di acquisto che non è mai stato rilevato in precedenza.
- Il server riceve una notifica in tempo reale per lo sviluppatore (RTDN), che indica che devi utilizzare il token di acquisto per ricevere le informazioni sul nuovo abbonamento.
- Non eseguire regolarmente il polling dell'API per verificare lo stato dell'abbonamento. Ad esempio, non chiamare l'API ogni giorno per controllare ogni abbonamento.
- Poiché ricevi un RTDN alla scadenza o al rinnovo dell'abbonamento, non devi pianificare una chiamata API in base alla data di scadenza pianificata.
API di reporting
L'API di reporting è destinata agli sviluppatori che vogliono creare flussi di lavoro automatici basati sui dati di Play Console o agli sviluppatori che utilizzano i dati di Play Console per analisi e report aziendali interni, potenzialmente insieme ad altri set di dati. Questo ti dà accesso programmatico a dati e metriche a livello di app per report, analisi e automazione interni.
L'API di reporting consente di accedere ai dati Android vitals, tra cui percentuale di arresti anomali, percentuale di ANR, problemi di wakeup e wakelock e analisi dello stack di errori.
Best practice
- Questa versione dell'API di reporting ha un limite predefinito di 10 query al secondo. Puoi visualizzare l'utilizzo delle quote nella sezione Quote della console Google Cloud. Se devi superare questo limite, puoi inviare una richiesta di quota utilizzando questo modulo.
API Reply to Reviews
L'API Reply to Reviews ti consente di visualizzare il feedback degli utenti relativi alla tua app e di rispondere a questo feedback. Puoi utilizzare questa API per interagire con gli utenti direttamente nel toolkit di assistenza clienti esistente, ad esempio in un sistema CRM.
L'API Reply to Reviews ti consente di accedere ai feedback solo per le versioni di produzione della tua app. Se vuoi ricevere feedback sulle versioni alpha o beta della tua app, usa Google Play Console. Inoltre, l'API mostra solo le recensioni che includono commenti. Se un utente valuta la tua app ma non fornisce un commento, il suo feedback non è accessibile dall'API.
API Autorizzazioni
L'APIPermissions offre agli sviluppatori la possibilità di automatizzare la gestione delle autorizzazioni all'interno di Play Console. In questo modo, hai un controllo flessibile su chi ha accesso al tuo account sviluppatore, senza alcun intervento manuale.
Con l'APIPermissions puoi eseguire funzioni amministrative come:
- Rimuovere l'accesso degli utenti quando lasciano l'azienda.
- Concedere l'accesso a un'app quando un utente entra a far parte del team competente.
API Voided purchase
L'API Voided Purchases fornisce un elenco di ordini associati agli acquisti annullati dall'utente. Puoi utilizzare le informazioni di questo elenco per implementare un sistema di revoca che impedisca all'utente di accedere ai prodotti di questi ordini.
Questa API si applica agli ordini in-app e agli abbonamenti alle app una tantum.
Un acquisto può essere annullato nei seguenti modi:
- L'utente richiede un rimborso per il suo ordine.
- L'utente annulla l'ordine.
- Un ordine viene riaddebitato.
- Lo sviluppatore annulla o rimborsa l'ordine. Nota: solo gli ordini revocati verranno mostrati nell'API Voided Purchases. Se lo sviluppatore esegue il rimborso senza impostare l'opzione di revoca, gli ordini non verranno visualizzati nell'API.
- Google annulla o rimborsa l'ordine.
Utilizzando questa API, contribuisci a creare un'esperienza più equilibrata e equa per tutti gli utenti della tua app, in particolare se la tua app è un gioco.