Prima di iniziare a effettuare chiamate API, devi configurare l'accesso API al tuo account sviluppatore Google Play. Questo comporta cambiamenti sia in Google Play Console sia in Google Cloud Console. Le istruzioni che seguono spiegano i quattro passaggi necessari per iniziare a utilizzare l'API Google Play Developer.
- Collega il tuo account sviluppatore a un progetto Google Cloud nuovo o esistente.
- Attiva l'API Google Play Developer per il tuo progetto Google Cloud collegato.
- Autorizzare una chiave API per l'API Google Play Developer nel tuo progetto Google Cloud collegato.
- Configura un account di servizio con le autorizzazioni di Google Play Console appropriate per accedere all'API Google Play Developer.
Collega il tuo account e il tuo progetto
Prima di poter accedere all'API Google Play Developer, devi collegare il tuo account sviluppatore Google Play a un progetto Google Cloud. Nella maggior parte dei casi, ti consigliamo di creare un nuovo progetto Google Cloud dedicato al tuo account sviluppatore Google Play, ma puoi collegare un progetto esistente. Tieni presente che ogni account sviluppatore Google Play può essere collegato a un solo progetto Google Cloud. Se hai più app nello stesso account sviluppatore Google Play, tutte devono condividere lo stesso progetto Google Cloud.
Crea un nuovo progetto
- Vai alla pagina Accesso API in Google Play Console.
- Fai clic su Crea nuovo progetto.
Il progetto Google Cloud viene creato e collegato automaticamente al tuo account sviluppatore Google Play.
Utilizza un progetto esistente
Se sei già un utente di Google Cloud Console, puoi collegarti al tuo progetto Google Cloud esistente seguendo questi passaggi:
- Vai alla pagina Accesso API in Google Play Console.
- Scegli il progetto da collegare. Se il tuo progetto non è presente nell'elenco, verifica che il tuo account utente sia designato come Proprietario nel progetto Google Cloud che vuoi collegare.
- Fai clic su Collega progetto esistente.
attiva l'API
Dopo aver configurato il progetto Google Cloud collegato, devi abilitare l'API Google Play Developer per questo progetto. A tale scopo, devi essere un proprietario del progetto Google Cloud.
- Vai alla pagina Accesso API in Google Play Console.
- Nella sezione API, individua l'API Google Play Developer e fai clic su Attiva.
Il progetto Google Cloud viene aggiornato direttamente e la modifica viene applicata immediatamente.
Autorizzare una chiave API
Per usare l'API, devi avere una chiave API nel progetto Google Cloud collegato che sia autorizzata a utilizzare l'API Google Play Developer. Configura questa funzionalità in Google Play Console.
Configura OAuth e account di servizio
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 account di servizio per accedere all'API.
Gli account di servizio devono essere utilizzati in un ambiente sicuro, ad esempio il tuo server. Le credenziali dell'account di servizio devono essere gestite in modo sicuro, quindi non vengono visualizzate a nessuno che non sia autorizzato 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 suo Account Google anziché con l'account di servizio. Questo consente di effettuare chiamate API per conto di un utente senza compromettere le credenziali dell'account di servizio.
- Account di servizio: un servizio software sicuro accede all'API (il più comune)
- Client OAuth: un utente accederà all'API
Utilizza un account di servizio
Puoi creare un account di servizio da Google Play Console.
- Vai alla pagina Accesso API in Google Play Console.
- In Account di servizio, fai clic su Scopri come creare account di servizio.
Segui le istruzioni per creare l'account di servizio.
Durante il processo di creazione dell'account, devi concedere al tuo account di servizio l'accesso al progetto Google Cloud affinché venga visualizzato in Google Play Console.
Dopo aver creato l'account di servizio in Google Play Console, fai clic su Fine. La sezione Account di servizio della pagina Accesso API si aggiorna automaticamente e il tuo account di servizio viene elencato.
Fai clic su Concedi l'accesso per fornire all'account di servizio i diritti necessari per eseguire le azioni.
Per utilizzare le API Fatturazione Google Play, devi concedere le seguenti autorizzazioni:
- Visualizzare dati finanziari, ordini e risposte al sondaggio sull'annullamento
- Gestire ordini e abbonamenti
A questo punto, dovresti essere in grado di accedere all'API Google Play Developer tramite l'account di servizio. Per ulteriori informazioni, consulta la pagina relativa all'utilizzo di OAuth 2.0 per le applicazioni server-server.
Utilizzare i client OAuth
Puoi consentire agli utenti di eseguire azioni utilizzando l'API utilizzando le proprie credenziali utilizzando un client OAuth. Le azioni di un utente sono limitate a quelle consentite tramite la pagina Utenti e autorizzazioni in Google Play Console.
Prima di creare i client OAuth, devi configurare le informazioni di branding per il prodotto. Per saperne di più, vedi Configurare la schermata per il consenso OAuth.
- Vai alla pagina Accesso API in Google Play Console.
- In Client OAuth, fai clic su Configura schermata consenso OAuth.
- Configura le informazioni di branding del tuo prodotto.
- Al termine, fai clic su Aggiorna consenso OAuth. La sezione si aggiorna e non vedrai più il messaggio sulle informazioni di branding.
Per creare un client OAuth utilizzando Google Play Console:
- Vai alla pagina Accesso API in Google Play Console.
- In Client OAuth, fai clic su Crea nuovo client OAuth.
- Segui le istruzioni riportate nella pagina per creare il client OAuth.
Dopo aver creato il client OAuth in Google Play Console, fai clic su Fine. La sezione Client OAuth della pagina Accesso API si aggiorna automaticamente e il client OAuth viene elencato.
A volte il nuovo client OAuth non viene visualizzato immediatamente nella pagina. In questo caso, fai clic su Aggiorna client OAuth.
I dettagli del nuovo client OAuth sono visualizzati in un elenco in questa pagina.
Informazioni aggiuntive
Leggi i seguenti suggerimenti utili per iniziare a utilizzare l'API su Google Play.
Ottenere il tuo ID sviluppatore
Alcune API richiedono di fornire un ID sviluppatore Google Play Console. Si tratta di un numero lungo assegnato al momento della creazione del tuo account sviluppatore Google Play. Puoi trovare il tuo ID sviluppatore nell'URL di quasi tutte le pagine di Google Play Console, ad esempio nella pagina Accesso API.
Ad esempio, considera l'URL di Google Play Console:
https://play.google.com/console/developers/1234567890123456789/api-access
Nell'URL riportato sopra, l'ID sviluppatore è 1234567890123456789.
Nota: se un'app viene trasferita da un account sviluppatore Google Play a un altro, l'ID sviluppatore associato all'app cambia. Ciò significa che, al termine del trasferimento, dovrai utilizzare l'ID sviluppatore per il nuovo account account sviluppatore Google Play nelle chiamate API relative all'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 di rispondere a questo feedback.
- API Veded Purchases
- Consente di revocare l'accesso ai prodotti in-app associati agli acquisti annullati da un utente.
Librerie client
Abbiamo fornito le librerie client che puoi utilizzare per accedere in modo programmatico alle API REST. Per ulteriori informazioni, consulta Librerie client ed esempi di codice.