Configurazione dei servizi per i giochi di Google Play

In questo documento viene spiegato come utilizzare Google Play Console per configurare i servizi per i giochi di Google Play per il tuo gioco Android. Google Play Console offre una posizione centralizzata per gestire i servizi per i giochi e configurare i metadati per autorizzare e autenticare il tuo gioco.

Per aggiungere il tuo gioco a Google Play Console, svolgi i seguenti passaggi generali:

• Crea un progetto di gioco e specifica dettagli come il nome e la descrizione del gioco.
• Crea e collega le credenziali necessarie per autorizzare e autenticare il gioco ai servizi per i giochi di Google Play.

Questi passaggi sono descritti più in dettaglio nelle sezioni seguenti.

Passaggio 1. Accedi a Google Play Console

Per accedere, vai a Google Play Console. Se non hai mai effettuato la registrazione a Google Play Console, ti verrà chiesto di farlo.

Passaggio 2. Aggiungi il tuo gioco a Google Play Console

Per aggiungere il gioco, procedi nel seguente modo:

1. Se non l'hai ancora fatto, crea un gioco in Play Console. Leggi qui per scoprire di più.
2. Vai a Crescita > Servizi per i giochi di Play > Configurazione e gestione > Configurazione.

3. Specifica se il gioco utilizza già le API di Google (ad esempio Firebase). Scegliere l'opzione corretta è molto importante.

   • Se si tratta di un gioco che stai creando da zero o se non hai mai configurato API di Google in precedenza, scegli No, il mio gioco non utilizza le API di Google. Inserisci il nome del gioco e fai clic su Crea.
   • Se si tratta di un gioco per cui hai già configurato una o più API di Google, scegli Sì, il mio gioco utilizza già le API di Google. Viene visualizzato un elenco dei progetti della console Google Cloud per i quali sei elencato come sviluppatore. Seleziona il progetto nell'elenco e poi fai clic su Utilizza.
   • Se vuoi utilizzare un progetto esistente dei servizi per i giochi di Play, scegli Utilizza un progetto esistente dei servizi per i giochi di Play. Vedrai un elenco di progetti esistenti dei servizi per i giochi di Play per il tuo account. Seleziona il progetto di gioco corretto dall'elenco, quindi fai clic su Utilizza. Non è una scelta tipica, ma potresti farlo se stai creando un nuovo gioco in Play Console per modificare il nome del pacchetto o se hai versioni senza costi e a pagamento del tuo gioco con nomi di pacchetto diversi.

4. Viene creato un progetto di gioco dei servizi per i giochi di Play e viene creata una voce corrispondente nella console Google Cloud.

5. Nella sezione Proprietà, puoi selezionare Modifica proprietà e aggiungere la descrizione, la categoria e le risorse grafiche del tuo gioco.

   • Per il test è richiesto solo il nome visualizzato. Per poter pubblicare il gioco, devi compilare gli altri campi.
   • Il nome visualizzato e la descrizione del gioco devono corrispondere a quelli configurati per la scheda del Play Store del tuo gioco.
   • Per le linee guida sulla creazione delle risorse grafiche, consulta la guida di Google Play per gli sviluppatori e le linee guida per le immagini in primo piano di Google Play.

Passaggio 3. Generare un ID client OAuth 2.0

Il tuo gioco deve avere un ID client OAuth 2.0 per poter essere autenticato e autorizzato a chiamare i servizi per i giochi di Google Play. Per configurare una credenziale per i servizi per i giochi di Play, ovvero l'associazione tra un ID client e il tuo gioco, utilizza Google Cloud Platform per creare l'ID client. Quindi usa Google Play Console per aggiungere una credenziale, collegando l'ID client al tuo gioco.

Per istruzioni più dettagliate, segui questi passaggi:

a. Configurare la schermata per il consenso OAuth

Se non hai ancora configurato la schermata per il consenso OAuth, nella sezione Credenziali verrà visualizzato un messaggio che ti chiede di eseguire la configurazione.

Fai clic su Configura. Viene visualizzata una finestra di dialogo con ulteriori istruzioni e un link diretto alla piattaforma Google Cloud.

Nota: assicurati che la schermata per il consenso sia disponibile per tutti gli utenti che possono accedere al gioco. L'elenco finale degli ambiti deve includere games, games_lite e drive.appdata; nessuno di questi ambiti richiederà la verifica dell'app. Ti consigliamo di pubblicare immediatamente la schermata per il consenso. Se non è possibile, puoi rendere disponibile la schermata del consenso ai tester per consentire loro di accedere al gioco.

Se hai completato la configurazione della schermata per il consenso OAuth, fai clic su Fine. Google Play Console si aggiorna automaticamente e, se la configurazione ha avuto esito positivo, potrai creare una credenziale:

b. Crea una credenziale

Per autorizzare il gioco a comunicare con i servizi per i giochi di Google Play, devi creare una credenziale con un ID client OAuth2 autorizzato.

Nella sezione Credenziali, fai clic su Aggiungi credenziale.

Nella procedura guidata, scegli se vuoi creare una credenziale di Android (se l'APK di gioco deve autenticare l'utente e utilizzare le API PGS) o una credenziale del server di gioco (se il server di gioco utilizza le API PGS). Segui le istruzioni specifiche per il tipo di credenziale desiderato.

Android

Configurare i dettagli delle credenziali

Assicurati che il nome nel campo Nome corrisponda al nome del tuo gioco. Scegli se attivare o meno l'antipirateria.

Configura l'autorizzazione

Successivamente, scegli un ID client OAuth da utilizzare per questo progetto di gioco. Se hai già ID client OAuth2, puoi sceglierne uno. Tuttavia, di solito ne crei una nuova. Fai clic su Crea client OAuth. Viene visualizzata una finestra di dialogo con link diretti e istruzioni per creare un ID client OAuth in Google Cloud Platform.

1. Seleziona Android come tipo di applicazione.
2. Inserisci il nome del gioco nel campo Nome.
3. Inserisci il nome del pacchetto dell'applicazione Android nel campo Nome del pacchetto.

4. Apri un terminale ed esegui l'utilità Keytool per recuperare le impronte SHA1 dei certificati di rilascio e di debug.

   Per ottenere l'impronta del certificato di rilascio, esegui il comando seguente:

   keytool -list -keystore <path-to-production-keystore> -v

   Per ottenere l'impronta del certificato di debug, esegui questo comando:

   keytool -list -keystore <path-to-debug-keystore> -v

   Nota: su Windows, l'archivio chiavi di debug si trova all'indirizzo C:\Users\<USERNAME>\.android\debug.keystore. Su Mac o Linux, l'archivio chiavi di debug si trova in genere all'indirizzo ~/.android/debug.keystore.

5. L'utilità keytool ti chiede di inserire una password per l'archivio chiavi. La password predefinita per l'archivio chiavi di debug è android. Lo strumento a chiave quindi stampa l'impronta sul terminale.

6. Incolla l'impronta SHA1 nel campo Signing certificate fingerprint (SHA1).

7. Fai clic su Crea.

Per ulteriori informazioni su OAuth 2.0 su Android, consulta Autenticazione a servizi OAuth2.

Avviso: assicurati di registrare il nome del pacchetto e il certificato di firma che hai configurato in questo passaggio. L'utilizzo di un nome di certificato o pacchetto diverso nell'applicazione causerà errori di autenticazione.

Dopo aver fatto clic su Fine nella finestra di dialogo, gli ID client disponibili verranno aggiornati. Scegli le credenziali che hai creato dal menu a discesa, quindi fai clic su Salva modifiche. In questo modo si creano le credenziali come bozza, consentendo di autenticarsi ai servizi per i giochi di Play nel proprio gioco.

Puoi creare due credenziali: una con l'impronta del certificato di rilascio e una con l'impronta del certificato di debug. Assicurati di utilizzare lo stesso nome di pacchetto. Ciò consente ai servizi per i giochi di Google Play di riconoscere le chiamate dai tuoi APK collegati che sono firmati con uno dei due certificati. Per maggiori informazioni sulla firma dei certificati per Android, consulta Firmare l'app.

Server di giochi

Configurare i dettagli delle credenziali

Assicurati che il nome nel campo Nome corrisponda al nome del tuo gioco.

Configura l'autorizzazione

Successivamente, scegli un ID client OAuth da utilizzare per questo progetto di gioco. Se hai già ID client OAuth2, puoi sceglierne uno. Tuttavia, di solito ne crei una nuova. Fai clic su Crea client OAuth. Viene visualizzata una finestra di dialogo con link diretti e istruzioni per creare un ID client OAuth in Google Cloud Platform.

1. Seleziona Applicazione web come tipo di applicazione.
2. Inserisci il nome del gioco nel campo Nome.
3. Fai clic su Crea.

Per ulteriori informazioni su OAuth 2.0 su Android, consulta Autenticazione a servizi OAuth2.

Dopo aver fatto clic su Fine nella finestra di dialogo, gli ID client disponibili verranno aggiornati. Scegli le credenziali che hai creato dal menu a discesa, quindi fai clic su Salva modifiche. In questo modo si creano le credenziali come bozza, consentendo di autenticarsi ai servizi per i giochi di Play dal proprio server di gioco. Per maggiori informazioni sull'utilizzo dei servizi per i giochi di Play con il tuo server di gioco, consulta l'articolo Attivare l'accesso lato server ai servizi per i giochi di Google Play.

Evitare i problemi di configurazione più comuni

Per evitare errori di configurazione comuni, assicurati di seguire questi consigli quando configuri il tuo gioco per l'utilizzo dei servizi per i giochi di Google Play.

1. Configurare il gioco con Google Play Console

Se hai creato un ID client OAuth 2.0 per la tua app in Google Cloud Console, i servizi per i giochi di Google Play non saranno in grado di conoscere l'associazione tra l'obiettivo e le classifiche del gioco e l'ID client. Per creare questa associazione, devi creare una credenziale utilizzando l'ID client Oauth 2.0 come descritto nella sezione Creare una credenziale.

2. Utilizzare l'ID applicazione corretto in Android

L'ID applicazione è una risorsa stringa obbligatoria a cui devi fare riferimento nel manifest Android. La stringa ID applicazione è composta solo da cifre (in genere pari o superiori a 12) all'inizio dell'ID client fornito da Google Play Console. L'ID applicazione si trova nella parte superiore della pagina Configurazione ed è etichettato come ID progetto sotto il nome del gioco.

3. Firma l'APK con il certificato corretto

Quando colleghi la tua app Android al tuo gioco in Google Play Console, devi utilizzare esattamente lo stesso nome di pacchetto e l'impronta del certificato che hai utilizzato per pubblicare l'app. In caso di mancata corrispondenza, le chiamate ai servizi per i giochi di Google Play non andranno a buon fine. Devi creare due ID client, uno con l'impronta del certificato di rilascio e un altro con l'impronta del certificato di debug e utilizzare lo stesso nome di pacchetto per entrambi. Per scoprire di più su come specificare il certificato di firma in Google Play Console, consulta la sezione Firma delle applicazioni.

4. Quando sviluppi per Android, includi l'SDK di Play Giochi come progetto della libreria, non come JAR autonomo

Assicurati che nell'SDK di Google Play Services venga fatto riferimento come progetto di libreria nel tuo progetto di Android, altrimenti potrebbero verificarsi errori quando la tua app non riesce a trovare risorse di Google Play Services. Per scoprire come configurare il tuo progetto Android per l'utilizzo di Google Play Services, consulta la pagina Configurare Google Play Services.

5. Accedere con un account tester durante lo sviluppo

Se non hai pubblicato le modifiche alle impostazioni del gioco in Google Play Console, potrebbero verificarsi errori durante il test se non hai eseguito l'accesso con un account tester autorizzato. Devi sempre attivare il tuo account editore Google Play Console per i test. Per informazioni su come gestire gli account tester, consulta Attivare gli account per i test.

6. Pubblicare la schermata per il consenso in Google Cloud Platform

Prima di pubblicare l'app in Google Play Console, pubblica la schermata per il consenso in Google Cloud Platform. Senza questo passaggio, il pubblico non potrà utilizzare le funzionalità dei servizi per i giochi di Play.

7. Al momento del rilascio, pubblica le impostazioni dei servizi per i giochi di Play prima di pubblicare il gioco

Gli sviluppatori potrebbero pubblicare accidentalmente la loro app senza pubblicare le impostazioni corrispondenti dei servizi per i giochi di Google Play per la loro app. Ciò potrebbe causare errori per i giocatori che accedono con account non-tester, in quanto l'app non può fare riferimento alle impostazioni corrette del gioco. Quando rilasci il gioco, ricordati di pubblicare prima le impostazioni di gioco utilizzando l'opzione Pubblica gioco in Google Play Console. Per scoprire come pubblicare le modifiche, consulta la pagina Pubblicare le modifiche del gioco.

Per ulteriori suggerimenti, consulta:

• Guida alla risoluzione dei problemi Android: documentazione per gli sviluppatori che descrive come risolvere i problemi durante lo sviluppo di giochi Android.

Passaggi successivi

Prima di procedere, devi aggiungere account di test al tuo gioco come descritto nella sezione Attivare gli account per i test. Gli utenti con account di test autorizzati avranno accesso al tuo progetto di gioco Play Services dei giochi non pubblicato e potranno testare il corretto funzionamento dei servizi per i giochi di Google Play configurati.

Una volta completate le attività di configurazione iniziali descritte in precedenza, puoi procedere con la configurazione delle funzionalità del tuo gioco, come le classifiche e gli obiettivi. Per saperne di più, consulta Attivare le funzionalità.