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 Authentication, lalu klik View in 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 acara peluncuran mendatang), Anda dapat meminta kuota tambahan dengan mengklik link Minta lebih banyak.

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 pengalihan 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 di sisi 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 ke project independen untuk memastikan konfigurasi yang tepat.

Dalam 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 yang baru.

Langkah 1: Persiapan backend

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

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

Langkah 2: Konfigurasi 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 Anda 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 agar operasi dapat meminimalkan interval waktu antara modifikasi dan pembuatan ulang.

Ubah nama paket klien Android Game 2 di project Google Cloud lama menjadi 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 ulang klien: Gunakan mekanisme konfigurasi dinamis Anda (seperti Remote Config) untuk segera mengalihkan aplikasi klien sehingga mulai menggunakan ID klien Web baru.
• Pertahankan klien lama: Pertahankan klien OAuth lama sebagai opsi penggantian untuk mengembalikan login klien OAuth sebelumnya jika ada masalah.