Mengelola setelan project Layanan game Play di Google Cloud

Mungkin ada kasus saat Anda ingin melihat dan mengedit project Layanan game Play langsung di Google Cloud.

Skenario standar meliputi:

• Mengaktifkan API tambahan untuk project Anda (seperti Google Drive).
• Mengedit informasi branding game Anda pada dialog OAuth 2.0.
• Melihat kuota API Anda dan meminta lebih banyak kuota (jika perlu).
• Mengedit URI resmi atau asal JavaScript di Client ID yang telah Anda buat sebelumnya.

Melihat project Anda

Untuk melihat project Anda di Google Cloud:

1. Pilih kredensial untuk game Anda di halaman Konfigurasi (Kembangkan pengguna > Layanan game Play > Penyiapan dan pengelolaan > Konfigurasi).
2. Buka bagian Autentikasi , lalu klik Lihat di Google Cloud.

Menyesuaikan kuota penggunaan API

Di Google Cloud, Anda dapat melihat batas penggunaan API yang disiapkan untuk game Anda dan jumlah kuota yang telah digunakan. Anda juga dapat menetapkan batas per pengguna untuk mencegah pengguna yang melakukan penyalahgunaan (atau klien game yang mengalami bug) menghabiskan kuota Anda.

Untuk melihat atau mengubah batas penggunaan untuk project Anda atau meminta penambahan kuota, lakukan hal berikut ini:

1. Jika Anda belum memiliki akun penagihan untuk project, buat akun penagihan.
2. Buka halaman API yang Diaktifkan dari library API di Konsol API, lalu pilih API dari daftar.
3. Untuk melihat dan mengubah setelan terkait kuota, pilih Kuota. Untuk melihat statistik penggunaan, pilih Penggunaan.

Perhatikan bahwa "pengguna" ditentukan berdasarkan alamat IP klien yang membuat permintaan kuota. Misalnya, jika semua permintaan Anda berasal dari satu server, server tersebut mungkin salah diberi tag sebagai satu pengguna berisi spam. Untuk mencegah hal ini, Anda dapat melampirkan argumen userIp=x.x.x.x ke permintaan endpoint API.

Untuk mempelajari lebih lanjut cara menetapkan kuota per pengguna, lihat Membatasi penggunaan API.

Selain batas per pengguna, ada batas seluruh aplikasi per hari untuk Google Play Games Services API. Biasanya, Anda tidak perlu mengubah batas yang telah dialokasikan sebelumnya. Namun, jika Anda mengantisipasi lonjakan volume yang besar (misalnya, untuk peristiwa peluncuran mendatang), Anda dapat meminta kuota tambahan dengan mengklik link Minta lebih banyak.

Melihat batas kapasitas OAuth dan batas pengguna baru

Untuk melihat kuota yang secara khusus terkait dengan kapasitas pemberian otorisasi pengguna OAuth dan batas pengguna baru:

1. Buka Konsol Google Cloud.
2. Pastikan Anda telah memilih project yang benar.
3. Buka API & Layanan > Layar izin OAuth.
4. Di halaman ini, Anda dapat melihat kapasitas pemberian otorisasi pengguna (atau kapasitas pemberian token) saat ini dan batas total pengguna baru.

Jika Anda melihat bahwa game Anda akan segera mencapai batas kapasitas, Anda harus mengambil tindakan untuk mencegah gangguan pada pemain dengan meminta penambahan kuota batas kapasitas.

Untuk mengetahui informasi selengkapnya, lihat Batas Kapasitas Aplikasi OAuth.

Mengaktifkan API lainnya

Saat Anda membuat client ID di Konsol Play, Google Play Games Services API akan otomatis diaktifkan untuk project Anda. Anda dapat mengaktifkan Google API lainnya dari Google Cloud.

Untuk mengaktifkan API untuk project Anda, lakukan hal berikut:

1. Buka Library API di Konsol API Google. Jika diminta, pilih project atau buat project baru. Library API menampilkan daftar semua API yang tersedia, yang dikelompokkan berdasarkan kelompok produk dan popularitas.

2. Jika API yang ingin Anda aktifkan tidak terlihat dalam daftar, gunakan penelusuran untuk mencarinya.

3. Pilih API yang ingin Anda aktifkan, lalu klik tombol Aktifkan.

4. Jika diminta, aktifkan penagihan.

5. Jika diminta, terima persyaratan layanan API.

Mengubah informasi branding

Untuk mengubah informasi branding (judul, logo, dll.) untuk game Anda yang muncul dalam dialog OAuth 2.0, tetapkan atribut di layar izin Google Cloud.

Untuk menyiapkan layar izin project Anda, lakukan langkah berikut:

1. Buka halaman Layar Izin di Konsol Play. Jika diminta, pilih project atau buat project baru.
2. Isi formulir lalu klik Simpan.

Mengubah jenis pengguna OAuth

Jika Anda melakukan pengujian di jalur pengujian Produksi (Uji dan rilis > Produksi) menggunakan akun pengujian pribadi, Anda juga harus mengonfigurasi setelan audiens OAuth di Google Cloud sebagai Eksternal. Untuk mengetahui informasi selengkapnya, lihat Mengelola audiens Aplikasi.

Mengubah atribut terkait client ID

Untuk mengubah atribut yang terkait dengan client ID OAuth 2.0 Anda (origin web dan URL alihan untuk aplikasi web, dll.):

1. Buka Konsol Play, lalu buka game Anda.
2. Pilih kredensial untuk game Anda di halaman Konfigurasi (Kembangkan pengguna > Layanan game Play > Penyiapan dan pengelolaan > Konfigurasi).
3. Scroll ke bagian bawah Autentikasi , lalu klik Lihat di Google Cloud.
4. Di Google Cloud, pilih project Anda.
5. Di sidebar sebelah kiri, pilih API &auth. Pastikan status Google Play Games Services API AKTIF dalam daftar API yang ditampilkan.
6. Di sidebar sebelah kiri, pilih Aplikasi terdaftar.
7. Luaskan bagian Client ID OAuth 2.0 dan cari atribut yang akan diedit.

Memigrasikan klien OAuth dari project Cloud yang ada

Untuk melihat project Anda di Google Cloud, ikuti langkah-langkah di Melihat project Anda.

Untuk menyiapkan Layanan game Play (PGS), project Google Cloud yang unik diperlukan. Jika beberapa game menggunakan satu project Cloud, Anda harus memigrasikan klien OAuth Android mereka ke project independen untuk memastikan konfigurasi yang tepat.

Pada contoh sebelumnya, Game 1 dan Game 2 telah membuat klien web dan Android mereka dalam satu project Google Cloud untuk Login dengan Google. Kita perlu memindahkan klien web dan Android Game 2 dari project Google Cloud lama saat ini ke project Google Cloud target baru.

Langkah 1: Persiapan backend

Sebelum melakukan peralihan, Anda harus menyesuaikan backend dan klien untuk menangani keberadaan Client ID Web lama dan baru secara bersamaan.

• Konfigurasi sisi server: Jika server Anda memvalidasi client ID web dalam token ID, Anda harus memperbarui logika sisi server untuk mendukung token ID yang dikeluarkan oleh klien lama di Project Cloud Lama dan klien baru yang perlu Anda buat di Project Cloud Target secara bersamaan.
• Konfigurasi sisi klien: Aplikasi klien Anda harus mendukung beberapa Client ID Web untuk login menggunakan Client ID Web baru saat beralih. Anda dapat menggunakan salah satu metode berikut:
  • Client ID Web 2 bawaan di aplikasi klien, beralih ke Client ID Web baru saat client ID lama berakhir masa berlakunya
  • Mendapatkan Client ID Web terbaru secara dinamis dari server untuk menyelesaikan peralihan
• Membuat klien Web terlebih dahulu: Di project target, Anda harus membuat klien Web baru terlebih dahulu untuk menghindari potensi penundaan selama peralihan atomik.

Langkah 2: Mengonfigurasi klien OAuth web dan Android baru di Google Cloud yang benar

Langkah 2.1: Buat klien OAuth web baru untuk Game 2 di project Google Cloud target:

Langkah 2.2: Peringatan: Mengubah klien Android akan mencegah pengguna game Anda login ke game menggunakan Login dengan Google, jadi Anda harus memastikan bahwa Anda melakukan Langkah 2.3 segera setelah Langkah 2.2. Sebaiknya buka 2 halaman web secara bersamaan untuk operasi guna meminimalkan interval waktu antara modifikasi dan pembuatan ulang.

Ubah nama paket klien Android Game 2 di project Google Cloud lama ke nilai yang tidak valid, seperti com.noexist.none.

Langkah 2.3: Segera buat klien Android baru untuk Game 2 dengan sidik jari SHA-1 dan nama paket Game 2 yang sama di project Google Cloud target:

Langkah 3: Deployment konfigurasi real-time

Setelah berhasil membuat klien Android baru di project target , segera lakukan hal berikut:

• Mengarahkan klien: Gunakan mekanisme konfigurasi dinamis Anda (seperti Remote Config) untuk segera mengalihkan aplikasi klien sehingga mulai menggunakan Client ID Web baru.
• Mempertahankan klien lama: Pertahankan klien OAuth lama sebagai opsi penggantian untuk melakukan roll back ke login klien OAuth sebelumnya jika terjadi masalah