Configura i servizi per i giochi di Google Play

Questa pagina descrive come configurare i servizi per i giochi di Google Play per il tuo gioco per Android utilizzando Google Play Console. Play Console offre una posizione centralizzata per 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

Completa i seguenti passaggi prima di configurare Google Play Games Services.

Creare un account sviluppatore Google Play

• Devi avere un account sviluppatore Google Play configurato in Play Console. Per maggiori informazioni, consulta la pagina Creare un account sviluppatore Google Play.

• Concedi l'autorizzazione di modifica: per modificare le impostazioni dei servizi per i giochi di Play in Play Console, il tuo team deve disporre delle autorizzazioni per gestire i servizi per i giochi di Play. Per ulteriori informazioni, vedi Aggiungere utenti all'account sviluppatore e gestire le autorizzazioni.

Crea un progetto Google Cloud

Devi aver configurato un progetto Google Cloud. Per ulteriori informazioni, vedi

• Guida introduttiva a Google Cloud
• Creare un progetto

Per utilizzare Play Console, devi attivare le API che prevedi di utilizzare con il tuo progetto.

gcloud services enable \
   --project "PROJECT" \
   "games.googleapis.com"

Accedere a Play Console

Per accedere, vai a Google Play Console. Se non ti sei mai registrato a Play Console, ti verrà chiesto di farlo.

Aggiungere il gioco a Play Console

Per aggiungere il tuo gioco, segui questi passaggi:

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

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

3. Specifica se il tuo gioco utilizza già API di Google (come Firebase). È importante scegliere l'opzione corretta, altrimenti il gioco potrebbe riscontrare problemi durante l'utilizzo delle API di Google. Ecco le opzioni:

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

   • Sì, il mio 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 dalla console Google Cloud. Seleziona il tuo progetto dall'elenco e poi fai clic su Utilizza.

   • Utilizza un progetto Servizi per i giochi di Play esistente: scegli questa opzione se vuoi utilizzare un progetto Servizi per i giochi di Play esistente. Vedrai un elenco dei progetti dei servizi per i giochi di Play esistenti per il tuo account. Seleziona il tuo progetto di gioco dall'elenco e poi fai clic su Utilizza. Questa 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 gioco con nomi dei pacchetti diversi.

   Viene creato un progetto di gioco dei servizi per i giochi di Play e viene creata una voce corrispondente per te 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 del gioco. Ecco alcune linee guida per la configurazione delle proprietà:

   • Per i test è obbligatorio solo il nome visualizzato. Gli altri campi devono essere compilati prima di poter pubblicare il gioco.

   • Il nome visualizzato e la descrizione del gioco devono corrispondere a quelli impostati nella scheda del Play Store del gioco.

   • Per le linee guida sulla creazione delle risorse grafiche, consulta Aggiungere risorse di anteprima per mettere in evidenza un'app e le linee guida per l'immagine in evidenza di Google Play.

Generare un ID client OAuth 2.0

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

Per istruzioni più dettagliate, segui questi passaggi:

Configura la schermata per il consenso OAuth

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

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

Assicurati che la schermata del consenso sia disponibile per tutti gli utenti a 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 del consenso. Se non è possibile, puoi rendere disponibile la schermata del consenso ai tester per consentire loro di autenticarsi 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:

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 vuoi creare una credenziale Android (se l'APK del gioco autenticherà l'utente e utilizzerà le API dei servizi per i giochi di Play) o una credenziale del server di giochi (se il server di giochi utilizzerà le API dei servizi per i giochi di Play). Segui le istruzioni specifiche per il tipo di credenziale che ti interessa.

Attiva i test

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

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

Gli utenti con account di test 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, attivando i servizi per i giochi di Play per un gruppo release di Play Console.

Per aggiungere singoli tester al tuo progetto di gioco:

1. Apri la scheda Tester del 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 da 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 l'accesso per i test a un gruppo, attiva una traccia di rilascio per accedere ai servizi per i giochi di Play:

Google Play semplifica la distribuzione delle versioni pre-release della tua app a gruppi controllati di utenti attendibili con le funzionalità dei canali di release. Consulta Impostare un test aperto, chiuso o interno sul sito web del Centro assistenza 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 release. Funziona come se li avessi aggiunti singolarmente all'elenco dei tester. A tale scopo, procedi nel seguente modo:

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

Le tracce selezionate verranno visualizzate nell'elenco delle tracce abilitate per i test dei servizi per i giochi di Play.

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

Evitare i problemi comuni

Per evitare errori di configurazione comuni, assicurati di seguire questi consigli quando configuri il tuo gioco per utilizzare i 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 nella console Google Cloud, i servizi per i giochi di Google Play non conosceranno l'associazione tra gli obiettivi 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 Crea 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 è etichettato come ID progetto sotto il nome del gioco.

3. Firma l'APK con il certificato corretto

Quando colleghi la tua app per Android al tuo gioco in Play Console, devi utilizzare esattamente lo stesso nome del pacchetto e la stessa 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 l'altro con l'impronta del certificato di debug, e utilizzare lo stesso nome del pacchetto per entrambi. Per scoprire di più su come specificare il certificato di firma in Play Console, consulta Firma delle applicazioni.

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

Assicurati che l'SDK Google Play Services sia indicato come progetto di libreria nel tuo progetto Android, altrimenti potrebbero verificarsi errori quando l'app non riesce a trovare le risorse di Google Play Services. Per scoprire come configurare il tuo progetto Android per utilizzare 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 inserito nella lista consentita. Devi sempre attivare il tuo account editore Play Console per i test. Per scoprire come gestire gli account tester, consulta la sezione Attivare gli account per i test.

6. Pubblica 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 prima 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 impostazioni corrispondenti dei servizi per i giochi di Play per la loro app. Ciò potrebbe causare errori per i giocatori che eseguono l'autenticazione con account non tester, poiché l'app non può fare riferimento alle impostazioni di gioco corrette. Quando rilasci il gioco, ricorda di pubblicare prima le impostazioni del gioco utilizzando l'opzione Pubblica gioco in Play Console. Per scoprire come pubblicare le modifiche, consulta Pubblicazione delle modifiche al gioco.

Per altri suggerimenti, consulta la guida alla risoluzione dei problemi di Android.

Passaggi successivi

Una volta completate le attività di configurazione iniziale descritte sopra, puoi attivare le funzionalità dei servizi per i giochi di Play per il tuo gioco, ad esempio partite salvate, classifiche e obiettivi.