Prima di poter iniziare a effettuare chiamate API, devi configurare l'accesso API al tuo account sviluppatore Google Play. Ciò comporta modifiche sia nella console Google Play che nella console Google Cloud. Le seguenti istruzioni spiegano i passaggi necessari per iniziare a utilizzare l'API Google Play Developer.
- Crea un progetto Google Cloud.
- Abilita l'API Google Play Developer per il tuo progetto Google Cloud.
- Configura un account di servizio con le autorizzazioni Google Play Console appropriate per accedere all'API Google Play Developer.
Crea un progetto Google Cloud
Puoi saltare questo passaggio se hai già un progetto Google Cloud che vuoi utilizzare.
Crea un progetto nella console Google Cloud.
Per ulteriori informazioni sui progetti Google Cloud, consulta la pagina Creare e gestire progetti.
Abilita l'API
Dopo aver configurato il progetto Google Cloud, devi abilitare l'API Google Play Developer per questo progetto.
Per attivare l'API Google Play Developer:
- Vai alla pagina dell'API Google Play Developer in Google Cloud Console.
- Fai clic su Abilita.
Configurare OAuth e i service account
Devi configurare l'accesso all'API Google Play Developer con un client OAuth o un account di servizio. Nella maggior parte dei casi, devi utilizzare un service account per accedere all'API.
I service account devono essere utilizzati in un ambiente sicuro, ad esempio il tuo server. Le credenziali del service account devono essere gestite in modo sicuro in modo che non vengano rivelate a persone non autorizzate a utilizzare l'API.
L'ID client OAuth deve essere utilizzato se devi accedere all'API per conto di un singolo utente. Ad esempio, se il tuo sito web deve accedere all'API Google Play Developer dal client web per conto dell'utente, puoi utilizzare l'ID client. L'utente verrà autenticato con il proprio Account Google anziché con il service account. In questo modo, puoi effettuare chiamate API per conto di un utente senza compromettere le credenziali del service account.
- Service account: un servizio software sicuro accederà all'API (il più comune)
- Client OAuth: un utente accederà all'API
Utilizzare un service account
Puoi creare un service account da Google Play Console.
- Nella console Google Cloud, vai ad Account di servizio.
- Fai clic su Crea service account e segui i passaggi.
- Vai alla pagina Utenti e autorizzazioni di Google Play Console.
- Fai clic su Invita nuovi utenti.
Inserisci un indirizzo email per il tuo service account nel campo dell'indirizzo email e concedi i diritti necessari per eseguire le azioni.
Per utilizzare le API Fatturazione Google Play, devi concedere le seguenti autorizzazioni:
- Visualizzazione di dati finanziari, ordini e risposte del sondaggio sull'annullamento
- Gestione di ordini e abbonamenti
Fai clic su Invita utente.
A questo punto, dovresti essere in grado di accedere all'API Google Play Developer tramite l'account di servizio. Per saperne di più, consulta l'articolo sull'utilizzo di OAuth 2.0 per applicazioni da server a server.
Utilizzare i client OAuth
Puoi consentire agli utenti di eseguire azioni utilizzando l'API con le proprie credenziali utilizzando un client OAuth. Le azioni di un utente sono limitate a quelle consentite tramite la pagina Utenti e autorizzazioni di Google Play Console.
Prima di creare client OAuth, devi configurare le informazioni sul branding per il tuo prodotto. Per saperne di più, consulta Configurare la schermata per il consenso OAuth.
- In Google Cloud Console, vai alla pagina Schermata per il consenso OAuth.
- Segui i passaggi per creare la schermata per il consenso OAuth.
Per creare un client OAuth:
- Nella console Google Cloud, vai a Credenziali.
- Fai clic su Crea credenziali > ID client OAuth.
- Scegli il tipo di richiesta e segui le istruzioni.
Informazioni aggiuntive
Utilizza i seguenti suggerimenti e trucchi per iniziare a utilizzare le API su Google Play.
Ottenere l'ID sviluppatore
Alcune API richiedono di fornire un ID sviluppatore Google Play Console. Si tratta di un numero lungo che è stato assegnato al momento della creazione del tuo account sviluppatore Google Play. Il tuo ID sviluppatore si trova nell'URL di quasi tutte le pagine di Google Play Console, ad esempio la pagina Accesso API.
Ad esempio, considera l'URL di Google Play Console:
https://play.google.com/console/developers/1234567890123456789/api-access
Nell'URL precedente, l'ID sviluppatore sarebbe 1234567890123456789.
Nota:se un'app viene trasferita da un account sviluppatore Google Play a un altro, l'ID sviluppatore associato all'app cambierà. Ciò significa che, una volta completato il trasferimento, devi utilizzare l'ID sviluppatore per il nuovo account sviluppatore Google Play nelle chiamate API per l'app.
API specializzate
L'API Google Play Developer contiene diverse API specializzate che ti consentono di eseguire tipi specifici di analisi sulla tua app:
- API Reply to Reviews
- Ti consente di visualizzare il feedback degli utenti per la tua app e rispondere.
- API Voided Purchases
- Ti consente di revocare l'accesso ai prodotti in-app associati agli acquisti che un utente ha annullato.
Librerie client
Abbiamo fornito librerie client che puoi utilizzare per accedere programmaticamente alle API REST. Per saperne di più, vedi Librerie client ed esempi di codice.