Potrebbero esserci casi in cui vorrai visualizzare e modificare il tuo progetto Play Games Services direttamente in Google Cloud.
Gli scenari tipici includono:
- Abilitare API aggiuntive per il tuo progetto (ad esempio Google Drive).
- Modifica delle informazioni sul branding del gioco nella finestra di dialogo OAuth 2.0.
- Visualizzazione della quota API e richiesta di un aumento (se necessario).
- Modifica degli URI o delle origini JavaScript autorizzati negli ID client che hai creato in passato.
Visualizza il tuo progetto
Per visualizzare il tuo progetto in Google Cloud:
- Seleziona una credenziale per il tuo gioco nella pagina Configurazione (Aumenta gli utenti > Servizi per i giochi di Play > Configurazione e gestione > Configurazione).
- Vai alla sezione Autenticazione e fai clic su Visualizza in Google Cloud.
Modificare le quote di utilizzo dell'API
In Google Cloud, puoi visualizzare i limiti di utilizzo delle API configurati per il tuo 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 tua quota.
Per visualizzare o modificare i limiti di utilizzo relativi al progetto o per richiedere un incremento della quota, procedi come segue:
- 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 tue richieste provengono da un unico server, questo server potrebbe essere erroneamente contrassegnato come un unico utente contenente spam. Per evitarlo, puoi allegare un argomento userIp=x.x.x.x alle richieste dell'endpoint API.
Per scoprire di più sull'impostazione delle quote per utente, vedi Limitazione dell'utilizzo dell'API.
Oltre a un limite per utente, esiste un limite giornaliero a livello di applicazione per l'API Google Play Games Services. In genere, non è necessario modificare il limite preassegnato. Tuttavia, se prevedi un forte aumento del volume (ad esempio, per un evento di lancio imminente), puoi richiedere una quota aggiuntiva facendo clic sul link Richiedi di più.
Attiva altre API
Quando crei l'ID client in Play Console, l'API Google Play Games Services viene attivata automaticamente per il tuo progetto. Puoi attivare altre API di Google da Google Cloud.
Per abilitare un'API per il tuo progetto:
Apri la libreria di API nella console API di Google. Se richiesto, seleziona un progetto o creane uno nuovo. La libreria di API elenca tutte le API disponibili, raggruppate per famiglia di prodotti e popolarità.
Se l'API che vuoi abilitare non è visibile nell'elenco, utilizza la ricerca per trovarla.
Seleziona l'API che vuoi abilitare, poi fai clic sul pulsante Abilita.
Se richiesto, abilita la fatturazione.
Se richiesto, accetta i termini di servizio dell'API.
Modificare le informazioni sul branding
Per modificare le informazioni di branding (titolo, logo e così via) del tuo 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 Produzione (Test e rilascio > Produzione) utilizzando un account di test personale, devi anche aver configurato 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 tuo gioco nella pagina Configurazione (Aumenta gli utenti > Servizi per i giochi di Play > 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 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 individua l'attributo da modificare.
Esegui la migrazione dei client OAuth da un progetto cloud esistente
Per visualizzare il tuo progetto in Google Cloud, segui i passaggi descritti in Visualizzare il progetto.
Per configurare i servizi per i giochi di Play (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 corretta configurazione.
Nell'esempio precedente, Gioco 1 e Gioco 2 hanno creato i propri client web e Android all'interno di un unico progetto Google Cloud per Accedi con Google. Dobbiamo spostare i client web e Android del gioco 2 dal progetto Google Cloud legacy attuale 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 cambio. Puoi utilizzare uno dei seguenti metodi:
- Due ID client web integrati nell'app client, con passaggio al nuovo ID client web alla scadenza del vecchio ID client
- Ottieni dinamicamente l'ultimo ID client web dal server per completare il passaggio
- Pre-crea client web: nel progetto di destinazione, devi creare un nuovo client web in anticipo per evitare potenziali ritardi durante il passaggio atomico.
Passaggio 2: configura 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 tuo gioco di accedere al gioco utilizzando Accedi con Google, pertanto devi assicurarti di eseguire il passaggio 2.3 immediatamente dopo il passaggio 2.2. Ti consigliamo di aprire due pagine web contemporaneamente per ridurre al minimo l'intervallo di tempo tra la modifica e la ricreazione.
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 di 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 target, esegui immediatamente le seguenti operazioni:
- Reindirizza i client: utilizza il meccanismo di configurazione dinamica (ad esempio Remote Config) per cambiare immediatamente l'applicazione client in modo che inizi a utilizzare il nuovo ID client web.
- Mantieni i client precedenti: mantieni i vecchi client OAuth come opzione di riserva per eseguire il rollback all'accesso con il client OAuth precedente in caso di problemi.