Potrebbero esserci casi in cui vorrai visualizzare e modificare il progetto Play Games Services direttamente in Google Cloud.
Ecco alcuni scenari tipici:
- Abilitare API aggiuntive per il progetto (ad esempio Google Drive).
- Modificare le informazioni sul branding del gioco nella finestra di dialogo OAuth 2.0.
- Visualizzare la quota API e richiederne una maggiore (se necessario).
- Modificare gli URI autorizzati o le origini JavaScript negli ID client creati in precedenza.
Visualizzare il progetto
Per visualizzare il progetto in Google Cloud:
- Seleziona una credenziale per il gioco nella pagina Configurazione (Aumenta il numero di utenti > Play Games Services > Configurazione e gestione > Configurazione).
- Vai alla sezione Autenticazione e fai clic su Visualizza in Google Cloud.
Modificare le quote di utilizzo delle API
In Google Cloud, puoi visualizzare i limiti di utilizzo delle API configurati per il gioco e la quantità di quota utilizzata. Puoi anche impostare limiti per utente per impedire a un utente molesto (o a un client di gioco con bug) di esaurire la quota.
Per visualizzare o modificare i limiti di utilizzo per il progetto o per richiedere un aumento della quota:
- Se non hai ancora un account di fatturazione per il progetto, creane uno.
- Visita la pagina API abilitate della libreria di API nella console API e seleziona un'API dall' elenco.
- Per visualizzare e modificare le impostazioni relative alla quota, seleziona Quote. Per visualizzare le statistiche sull'utilizzo, seleziona Utilizzo.
Tieni presente che gli "utenti" vengono determinati in base all'indirizzo IP del client che effettua la richiesta di quota. Ad esempio, se tutte le richieste provengono da un singolo server, quest'ultimo potrebbe essere erroneamente contrassegnato come un singolo utente di spam. Per evitare questo problema, puoi aggiungere un argomento userIp=x.x.x.x alle richieste dell'endpoint API.
Per saperne di più sull'impostazione delle quote per utente, vedi Limitare l'utilizzo delle API.
Oltre a un limite per utente, esiste un limite per giorno a livello di applicazione per l'API dei servizi per i giochi di Google Play. In genere, non è necessario modificare il limite preallocato. Tuttavia, se prevedi un aumento significativo del volume (ad esempio, per un evento di lancio imminente), puoi richiedere una quota aggiuntiva facendo clic sul link Richiedi di più.
Attivare altre API
Quando crei l'ID client in Play Console, l'API di Google Play Games Services viene attivata automaticamente per il progetto. Puoi attivare altre API di Google da Google Cloud.
Per attivare un'API per il progetto:
Apri la libreria API nella console API di Google. Se richiesto, seleziona un progetto o creane uno nuovo. La libreria API elenca tutte le API disponibili, raggruppate per famiglia di prodotti e popolarità.
Se l'API che vuoi attivare non è visibile nell'elenco, utilizza la ricerca per trovarla.
Seleziona l'API che vuoi attivare, quindi fai clic sul pulsante Attiva.
Se richiesto, abilita la fatturazione.
Se richiesto, accetta i Termini di servizio dell'API.
Modificare le informazioni sul branding
Per modificare le informazioni sul branding (titolo, logo e così via) del gioco visualizzate nella finestra di dialogo OAuth 2.0, imposta gli attributi nella schermata per il consenso di Google Cloud.
Per configurare la schermata per il consenso del progetto:
- Apri la pagina Schermata per il consenso in Play Console. Se richiesto, seleziona un progetto o creane uno nuovo.
- Compila il modulo e fai clic su Salva.
Modificare il tipo di utente OAuth
Se esegui test nella traccia di test di Produzione (Test e rilascio > Produzione) utilizzando un account di test personale, devi aver configurato anche l'impostazione del pubblico OAuth in Google Cloud come Esterno. Per saperne di più, vedi Gestire il pubblico dell'app.
Modificare gli attributi correlati all'ID client
Per modificare gli attributi correlati all'ID client OAuth 2.0 (origini web e URL di reindirizzamento per un'app web e così via):
- Apri Play Console e vai al tuo gioco.
- Seleziona una credenziale per il gioco nella pagina Configurazione (Aumenta il numero di utenti > Play Games Services > Configurazione e gestione > Configurazione).
- Scorri fino alla fine della sezione Autenticazione e fai clic su Visualizza in Google Cloud.
- In Google Cloud, seleziona il progetto.
- Nella barra laterale a sinistra, seleziona API e autenticazione. Assicurati che lo stato dell'API di Google Play Games Services sia ON nell'elenco delle API visualizzato.
- Nella barra laterale a sinistra, seleziona App registrate.
- Espandi la sezione ID client OAuth 2.0 e trova l'attributo da modificare.
Eseguire la migrazione dei client OAuth da un progetto Cloud esistente
Per visualizzare il progetto in Google Cloud, segui i passaggi descritti in Visualizzare il progetto.
Per configurare Play Games Services (PGS), è necessario un progetto Google Cloud univoco. Se più giochi condividono un progetto Cloud, devi eseguire la migrazione dei relativi client OAuth per Android a progetti indipendenti per garantire una configurazione corretta.
Nell'esempio precedente, il gioco 1 e il gioco 2 hanno creato i propri client web e Android in un unico progetto Google Cloud per Accedi con Google. Dobbiamo spostare i client web e Android del gioco 2 dal progetto Google Cloud legacy corrente a un nuovo progetto Google Cloud di destinazione.
Passaggio 1: preparazione del backend
Prima di eseguire il passaggio, devi adattare il backend e i client per gestire l'esistenza simultanea di ID client web vecchi e nuovi.
- Configurazione lato server: se il server convalida l'ID client web all'interno del token ID, dovrai aggiornare la logica lato server per supportare contemporaneamente i token ID emessi sia dai vecchi client nel progetto Cloud legacy sia dai nuovi client che devi generare nel progetto Cloud di destinazione.
- Configurazione lato client: l'applicazione client deve supportare
più ID client web per accedere utilizzando il nuovo ID client web durante il
passaggio. Puoi utilizzare uno dei seguenti metodi:
- 2 ID client web integrati nell'app client, passando al nuovo ID client web alla scadenza del vecchio ID client
- Ottenere dinamicamente l'ultimo ID client web dal server per completare il passaggio
- Precreare i client web: nel progetto di destinazione, devi creare in anticipo un nuovo client web per evitare potenziali ritardi durante il passaggio atomico.
Passaggio 2: configurare i nuovi client OAuth web e Android nel progetto Google Cloud corretto
Passaggio 2.1: crea un nuovo client OAuth web per il gioco 2 nel progetto Google Cloud di destinazione:
Passaggio 2.2: avviso. La modifica del client Android impedirà agli utenti del gioco di accedere al gioco utilizzando Accedi con Google, pertanto devi assicurarti di eseguire il passaggio 2.3 immediatamente dopo il passaggio 2.2. Per ridurre al minimo l'intervallo di tempo tra la modifica e la ricreazione, ti consigliamo di aprire contemporaneamente due pagine web per le operazioni.
Modifica il nome del pacchetto del client Android del gioco 2 nel progetto Google Cloud legacy con un valore non valido, ad esempio com.noexist.none.
Passaggio 2.3: crea immediatamente un nuovo client Android per il gioco 2 con lo stesso nome del pacchetto e la stessa impronta SHA-1 del gioco 2 nel progetto Google Cloud di destinazione:
Passaggio 3: deployment della configurazione in tempo reale
Dopo aver creato correttamente il nuovo client Android nel progetto di destinazione , esegui immediatamente le seguenti operazioni:
- Reindirizzare i client: utilizza il meccanismo di configurazione dinamica (ad esempio Remote Config) per passare immediatamente all'applicazione client in modo che inizi a utilizzare il nuovo ID client web.
- Mantenere i vecchi client: conserva i vecchi client OAuth come opzione di fallback per eseguire il rollback all'accesso con il client OAuth precedente in caso di problemi arise.