Configura i servizi per i giochi di Google Play

In questa pagina viene descritto come configurare i servizi per i giochi di Google Play per il tuo gioco Android utilizzando Google Play Console. Play Console offre una posizione centralizzata in cui gestire i servizi per i giochi e configurare i metadati utilizzati per autorizzare e autenticare il gioco.

Per aggiungere il tuo gioco a Play Console, segui questi passaggi generali:

  • Crea un progetto di gioco per il tuo gioco e specifica dettagli come il nome e la descrizione del gioco.

  • Crea e collega le credenziali necessarie per autorizzare e autenticare il tuo gioco ai servizi per i giochi di Google Play.

Prima di iniziare

Accedi a Play Console

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

Aggiungere il gioco a Play Console

Per aggiungere il tuo gioco, svolgi i seguenti passaggi:

  1. In Play Console, crea un'app e specifica che si tratta di un gioco. Per maggiori informazioni, consulta Creare e configurare un'app.

  2. Vai a Crescita > Servizi per i giochi di Play > Configurazione e gestione > Configurazione.

  3. Specifica se il gioco utilizza già API di Google (ad esempio Firebase). È importante scegliere l'opzione corretta; in caso contrario, il gioco potrebbe riscontrare problemi durante l'utilizzo delle API di Google. Di seguito sono riportate le opzioni disponibili:

    • No, il mio gioco non utilizza API di Google. Se stai creando un nuovo gioco o non hai mai configurato un'API di Google, scegli questa opzione. Inserisci il nome del gioco e fai clic su Crea.

    • Sì, il gioco utilizza già API di Google: scegli questa opzione se hai già configurato un'API di Google per il gioco. In questo caso, vedrai un elenco dei tuoi progetti nella console Google Cloud. Seleziona il progetto dall'elenco e fai clic su Utilizza.

    • Utilizza un progetto dei servizi per i giochi di Play esistente. Se vuoi utilizzare un progetto dei servizi per i giochi di Play esistente, scegli questa opzione. Vedrai un elenco di progetti dei servizi per i giochi di Play esistenti per il tuo account. Seleziona il progetto di gioco dall'elenco e fai clic su Usa. Non è una scelta tipica, ma puoi farlo se crei un nuovo gioco in Play Console per cambiare il nome del pacchetto o se disponi di versioni senza costi e a pagamento del gioco con nomi di pacchetti diversi.

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

  4. Nella sezione Proprietà, fai clic su Modifica proprietà per aggiungere informazioni, come la descrizione, la categoria e le risorse grafiche relative al gioco. Di seguito sono riportate alcune linee guida per la definizione delle proprietà:

Generare un ID client OAuth 2.0

Il gioco deve avere un ID client OAuth 2.0 per 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 la piattaforma Google Cloud per creare l'ID client. Poi usa Google Play Console per aggiungere una credenziale, collegando l'ID client al tuo gioco.

Per istruzioni più dettagliate, vedi i seguenti passaggi:

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.

Richiesta di configurazione della schermata per il consenso OAuth

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

Richiesta di configurazione della schermata per il consenso OAuth.

Assicurati che la schermata di consenso sia disponibile per tutti gli utenti per cui è disponibile il 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 ciò non è possibile, puoi rendere disponibile la schermata per il 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 è andata a buon fine, potrai creare una credenziale:

Creazione di una credenziale

Crea una credenziale

Per autorizzare il tuo 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 creare una credenziale Android (se l'APK di gioco autenticherà l'utente e utilizzerà le API dei servizi per i giochi di Play) o una credenziale per il server di gioco (se il server di gioco utilizzerà le API dei servizi per i giochi di Play). 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 gioco. Scegli se attivare l'opzione Antipirateria.

Configura l'autorizzazione

Poi, scegli un ID client OAuth da usare per questo progetto di gioco. Se hai già ID client OAuth2, puoi sceglierne uno. Tuttavia, in genere ne crei uno nuovo. Fai clic su Crea client OAuth. Si apre 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 ottenere le fingerprint SHA1 dei certificati di release e debug.

    Per ottenere la fingerprint del certificato di rilascio, esegui questo comando:

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

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

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

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

  6. Incolla l'impronta SHA1 nel campo Impronta digitale certificato di firma (SHA1).

  7. Fai clic su Crea.

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

Dopo aver fatto clic su Fine nella finestra di dialogo, gli ID client disponibili verranno aggiornati. Scegli la credenziale creata dal menu a discesa e fai clic su Salva modifiche. La credenziale viene creata come bozza e potrai autenticarti ai servizi per i giochi di Play nel tuo gioco.

Potresti creare due credenziali: una con l'impronta digitale del certificato di rilascio e l'altra con l'impronta digitale del certificato di debug. Assicurati di utilizzare lo stesso nome di pacchetto per entrambi. In questo modo i servizi per i giochi di Google Play possono riconoscere le chiamate provenienti dagli APK collegati firmati con entrambi i certificati. Per ulteriori informazioni sulla firma dei certificati per Android, consulta l'articolo su come firmare l'app.

Server di giochi

Configurare i dettagli delle credenziali

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

Configura l'autorizzazione

Poi, scegli un ID client OAuth da usare per questo progetto di gioco. Se hai già ID client OAuth2, puoi sceglierne uno. Tuttavia, in genere ne crei uno nuovo. Fai clic su Crea client OAuth. Si apre 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 nei servizi OAuth2.

Dopo aver fatto clic su Fine nella finestra di dialogo, gli ID client disponibili verranno aggiornati. Scegli la credenziale creata dal menu a discesa e fai clic su Salva modifiche. La credenziale viene creata come bozza e potrai autenticarti ai servizi per i giochi di Play dal tuo server di gioco. Per ulteriori informazioni sull'utilizzo dei servizi per i giochi di Play con il tuo server di gioco, consulta Attivare l'accesso lato server ai servizi per i giochi di Google Play.

Abilita test

Per assicurarti che i servizi per i giochi di Google Play funzionino correttamente nel tuo gioco, devi testare i servizi per i giochi prima di pubblicare le modifiche su Google Play.

Se il gioco è in stato non pubblicato, concedi l'accesso ai tester aggiungendo i loro account utente alla lista consentita. In caso contrario, i tester rileveranno errori OAuth e 404 quando tentano di accedere agli endpoint dei servizi per i giochi di Play, ad esempio l'endpoint di accesso.

Gli utenti con account di prova autorizzati avranno accesso al tuo progetto di gioco dei servizi per i giochi di Play non pubblicato e potranno verificare che i servizi per i giochi di Play configurati funzionino correttamente.

Esistono due modi per consentire ai tester di utilizzare le API dei servizi per i giochi di Play per il tuo gioco:

  • A livello individuale, aggiungendo singoli indirizzi email.

  • A livello di gruppo, abilitando i servizi per i giochi di Play per un canale di rilascio di Play Console.

Per aggiungere singoli tester al tuo progetto di gioco:

  1. Apri la scheda Tester relativa al tuo gioco in Google Play Console (Crescita > Servizi per i giochi di Play > Configurazione e gestione > Tester).
  2. Fai clic sul pulsante Aggiungi tester.
  3. Nella finestra di dialogo visualizzata, inserisci gli indirizzi email degli Account Google che vuoi aggiungere come tester (separati con virgole o un indirizzo email per riga).
  4. Fai clic su Aggiungi per salvare gli utenti come tester. Gli account tester che hai aggiunto dovrebbero essere in grado di accedere ai servizi per i giochi di Play entro un paio d'ore.

Per concedere a un gruppo l'accesso ai test, abilita un canale di rilascio per accedere ai servizi per i giochi di Play:

Google Play semplifica la distribuzione delle versioni di pre-release della tua app a gruppi controllati di utenti attendibili grazie alle funzionalità del canale di rilascio. Consulta la pagina relativa alla configurazione di un test aperto, chiuso o interno sul sito web dell'assistenza di Google Play.

Puoi concedere l'accesso per testare il tuo gioco a tutti gli utenti che hanno accesso agli APK di test in un determinato canale di rilascio. Funziona come se i tester fossero stati aggiunti singolarmente all'elenco dei tester. A tale scopo, proceda nel seguente modo:

  1. Apri la sezione Tester PGS (Crescita > Servizi per i giochi di Play > Configurazione e gestione > Tester) e seleziona la scheda Canali di rilascio. In questa pagina puoi anche trovare l'elenco di tracce già abilitate per i test dei servizi per i giochi di Play.
  2. Fai clic su Aggiungi tracce.
  3. Seleziona uno o più canali da attivare per i test dei servizi per i giochi di Play.
  4. Fai clic su Aggiungi tracce.

I canali di rilascio selezionati verranno visualizzati nell'elenco dei canali abilitati per i test dei servizi per i giochi di Play.

Questa funzionalità è disponibile solo se hai un'app Android collegata al tuo gioco in Google Play Console.

Evitare problemi comuni

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

1. Configurare il gioco con 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 rileveranno 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 in 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 dell'ID applicazione è composta solo dalle cifre (in genere 12 o più) all'inizio dell'ID client fornito da Play Console. L'ID applicazione si trova nella parte superiore della pagina Configurazione ed è contrassegnato come ID progetto sotto il nome del gioco.
3. Firma l'APK con il certificato corretto
Per collegare l'app Android al tuo gioco in Play Console, devi utilizzare esattamente lo stesso nome di pacchetto e fingerprint 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, utilizzando lo stesso nome di pacchetto per entrambi. Per scoprire di più su come specificare il certificato di firma in Play Console, consulta la pagina Firma delle applicazioni.
4. Quando sviluppi per Android, includi l'SDK Play Giochi come progetto libreria, non come JAR autonomo.
Assicurati che l'SDK Google Play Services venga indicato come progetto libreria nel tuo progetto Android, altrimenti potrebbero verificarsi errori se la tua app non riesce a trovare le risorse di Google Play Services. Per scoprire come configurare il tuo progetto Android per l'utilizzo di Google Play Services, consulta Configurazione di Google Play Services.
5. Accedere con un account tester durante lo sviluppo
Se non hai pubblicato le modifiche alle impostazioni del gioco in Play Console, potresti riscontrare errori durante i test se non hai eseguito l'accesso con un account tester autorizzato. Devi sempre abilitare il tuo account editore di Play Console per i test. Per informazioni su come gestire gli account tester, consulta Attivazione degli account per i test.
6. Pubblicare la schermata per il consenso in Google Cloud Platform
Prima di pubblicare l'app in Play Console, pubblica la schermata per il consenso in Google Cloud Platform. Senza questo passaggio, il pubblico non potrà utilizzare nessuna delle 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 propria app senza pubblicare le relative impostazioni dei servizi per i giochi di Play. Di conseguenza, i giocatori che accedono con account non tester potrebbero riscontrare errori perché l'app non può fare riferimento alle impostazioni di gioco corrette. Quando rilasci il gioco, ricordati di pubblicare prima le impostazioni del gioco usando l'opzione Pubblica gioco in Play Console. Per scoprire come pubblicare le modifiche, consulta la pagina relativa alla pubblicazione delle modifiche al gioco.

Per ulteriori suggerimenti, consulta la Guida alla risoluzione dei problemi con Android.

Passaggi successivi

Dopo aver completato le attività di configurazione iniziali descritte sopra, puoi attivare le funzionalità dei servizi per i giochi di Play per il tuo gioco, ad esempio partite salvate, classifiche e obiettivi.