Per iniziare

Prima di poter iniziare a effettuare chiamate API, devi configurare l'accesso API al tuo account sviluppatore Google Play. Ciò comporta modifiche sia in Google Play Console che in Google Cloud Console. Le seguenti istruzioni spiegano i passaggi necessari per iniziare a utilizzare l'API Google Play Developer.

  1. Creare un progetto Google Cloud.
  2. Attiva l'API Google Play Developer per il tuo progetto Google Cloud.
  3. Configura un account di servizio con le autorizzazioni di 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 Creazione e gestione dei 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:

  1. Vai alla pagina dell'API Google Play Developer in Google Cloud Console.
  2. Fai clic su Abilita.

Configurare 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 in modo che non siano visibili a nessuno che non sia autorizzato a utilizzare l'API.

Utilizza l'ID client OAuth 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 l'account di servizio. In questo modo puoi effettuare chiamate API per conto di un utente senza compromettere le credenziali dell'account di servizio.

  • Account di servizio: un servizio software sicuro accederà all'API (opzione più comune).
  • Client OAuth: un utente accederà all'API

Utilizza un account di servizio

Puoi creare un account di servizio da Google Play Console.

  1. Nella console Google Cloud, vai ad Account di servizio.
  2. Fai clic su Crea account di servizio e segui i passaggi.
  3. Vai alla pagina Utenti e autorizzazioni di Google Play Console.
  4. Fai clic su Invita nuovi utenti.
  5. Inserisci un indirizzo email per il tuo account di servizio nel campo dell'indirizzo email e concedi i diritti necessari per eseguire azioni.

    Per utilizzare le API Fatturazione Google Play, devi concedere le seguenti autorizzazioni:

    • Visualizzazione di dati finanziari, ordini e risposte del sondaggio sull'annullamento
    • Gestire ordini e abbonamenti
  6. Fai clic su Invita utente.

A questo punto dovresti riuscire ad accedere all'API Google Play Developer tramite l'account di servizio. Per ulteriori informazioni, consulta l'articolo sull'utilizzo di OAuth 2.0 per le applicazioni da server a server.

Utilizzare i client OAuth

Puoi consentire agli utenti di eseguire azioni utilizzando l'API con le proprie credenziali mediante 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, è necessario configurare le informazioni di branding per il prodotto. Per saperne di più, consulta Configurare la schermata per il consenso OAuth.

  1. Nella console Google Cloud, vai alla pagina della schermata per il consenso OAuth.
  2. Segui i passaggi per creare la schermata per il consenso OAuth.

Per creare un client OAuth:

  1. Nella console Google Cloud, vai a Credenziali.
  2. Fai clic su Crea credenziali > ID client OAuth.
  3. Scegli il tipo di applicazione e segui le istruzioni.

Informazioni aggiuntive

Segui i seguenti suggerimenti utili per iniziare a utilizzare le API su Google Play.

Ottenere il tuo ID sviluppatore

Per alcune API è necessario fornire un ID sviluppatore Google Play Console. Questo è un numero lungo che ti è stato assegnato al momento della creazione del tuo account sviluppatore Google Play. Il tuo ID sviluppatore è indicato nell'URL di quasi tutte le pagine di Google Play Console, ad esempio la pagina Accesso alle API.

Prendiamo in considerazione, ad esempio, 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 del nuovo account sviluppatore Google Play nelle chiamate API per l'app in questione.

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 relativo alla tua app e di rispondere al feedback.
API Voided Purchases
Ti consente di revocare l'accesso ai prodotti in-app associati ad acquisti annullati dall'utente.

Librerie client

Abbiamo fornito librerie client che puoi utilizzare per accedere in modo programmatico alle API REST. Per ulteriori informazioni, consulta Librerie client ed esempi di codice.