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 un punto di riferimento centralizzato per gestire i servizi per i giochi e configurare i metadati utilizzati per autorizzare e autenticare il tuo 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 su Google Play Services.

Prima di iniziare

Completa i seguenti passaggi prima di configurare Google Play Services per i giochi.

Creare un account sviluppatore Google Play

• Devi avere configurato un account sviluppatore Google Play in Play Console. Per ulteriori 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, consulta 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"

Accedi a Play Console

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

Aggiungere il gioco a Play Console

Per aggiungere il tuo gioco:

1. In Play Console, crea un'app e specifica che si tratta di un gioco. Per ulteriori informazioni, consulta 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 (ad esempio Firebase). È importante scegliere l'opzione corretta, altrimenti il tuo gioco potrebbe riscontrare problemi durante l'utilizzo delle API di Google. Ecco le opzioni:

   • No, il mio gioco non utilizza API di Google: scegli questa opzione se stai creando un nuovo gioco o se non hai mai configurato un'API di Google per il gioco. Inserisci il nome del 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 nella console Google Cloud. Seleziona il progetto dall'elenco, quindi fai clic su Utilizza.

   • Utilizza un progetto Servizi per i giochi di Google Play esistente: se vuoi utilizzare un progetto esistente, scegli questa opzione. Viene visualizzato un elenco dei progetti dei servizi per i giochi di Play esistenti per il tuo account. Seleziona il 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 cambiare 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 per i servizi per i giochi di Google Play e viene creata una voce corrispondente in Google Cloud Console.

4. Nella sezione Proprietà, fai clic su Modifica proprietà per aggiungere informazioni, come la descrizione, la categoria e le risorse grafiche del tuo gioco. Ecco alcune linee guida per la configurazione delle proprietà:

   • Per i test è richiesto 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 quanto impostato nella scheda del Play Store del gioco.

   • Per le linee guida sulla creazione delle risorse grafiche, consulta la pagina Aggiungere risorse di anteprima per mettere in evidenza un'app e le linee guida per le immagini in primo piano di Google Play.

Generare un ID client OAuth 2.0

Il tuo 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 Play Games, ovvero l'associazione tra un ID client e il tuo gioco, utilizza la piattaforma Google Cloud per creare l'ID client. Quindi, utilizza Google Play Console per aggiungere una credenziale, collegando l'ID client al tuo gioco.

Per istruzioni più dettagliate, segui i passaggi che seguono:

Configura 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. Si apre una finestra di dialogo con ulteriori istruzioni e un link dettagliato alla piattaforma Google Cloud.

Assicurati che la schermata di 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 richiede la verifica dell'app. Ti consigliamo di pubblicare immediatamente la schermata del consenso. Se non è possibile, puoi rendere disponibile la schermata del consenso per consentire ai tester 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:

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 del gioco autentica l'utente e utilizza le API Play Giochi) o una credenziale del server di giochi (se il server di giochi utilizza le API Play Giochi). Segui le istruzioni specifiche per il tipo di credenziale che ti interessa.

Attivare i test

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

Se il tuo gioco non è stato pubblicato, concedi l'accesso ai tester aggiungendo i loro account utente alla lista consentita. In caso contrario, i tester riscontreranno errori OAuth e 404 durante il tentativo di accedere agli endpoint di Play Services, ad esempio l'endpoint di accesso.

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

Esistono due modi per consentire ai tester di utilizzare le API Play Services 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 canale di release di Play Console.

Per aggiungere singoli tester al tuo progetto di gioco:

1. Apri la scheda Tester per il 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 a un gruppo l'accesso per i test, abilita un canale 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à del canale 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. Il funzionamento è lo stesso che se li avessi aggiunti singolarmente all'elenco dei tester. A tale scopo, procedi 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 vedere l'elenco dei canali già abilitati per i test di Play Services.
2. Fai clic su Aggiungi tracce.
3. Seleziona uno o più canali da attivare per i test di Play Services.
4. Fai clic su Aggiungi tracce.

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

Questa funzionalità è disponibile solo se hai un'app per Android collegata 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 l'utilizzo di Google Play Services.

1. Configurare il gioco con Play Console

Se hai creato un ID client OAuth 2.0 per la tua app nella console Google Cloud, Google Play Services per i giochi non sarà a conoscenza dell'associazione tra i risultati 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. Utilizza l'ID applicazione corretto in Android

L'ID applicazione è una risorsa stringa obbligatoria a cui devi fare riferimento nel file manifest di Android. La stringa dell'ID applicazione è costituita solo dalle cifre (in genere almeno 12) all'inizio dell'ID cliente 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. Firmare l'APK con il certificato corretto

Quando colleghi l'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 cliente, uno con la fingerprint del certificato di rilascio e un altro con la fingerprint 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 Games come progetto di libreria, non come JAR autonomo.

Assicurati che all'SDK Google Play Services venga fatto riferimento come progetto di libreria nel progetto Android, altrimenti potrebbero verificarsi errori quando l'app non riesce a trovare le risorse di Google Play Services. Per scoprire come configurare il 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 il test se non hai eseguito l'accesso con un Account tester inserito nella lista consentita. Devi sempre attivare il tuo account editore di Play Console per i test. Per scoprire come gestire gli account dei tester, consulta Attivare gli account per i test.

6. Pubblica la schermata per il consenso nella piattaforma Google Cloud

Prima di pubblicare l'app in Play Console, pubblica la schermata per il consenso in Google Cloud. Senza questo passaggio, il pubblico pubblico non potrà utilizzare nessuna delle funzionalità di Play Services.

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

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

Passaggi successivi

Dopo aver completato le attività di configurazione iniziale descritte sopra, puoi attivare le funzionalità di Play Services per il tuo gioco, ad esempio partite salvate, classifiche e obiettivi.