Menyiapkan Layanan game Google Play

Dokumen ini membahas cara menggunakan Konsol Google Play untuk menyiapkan layanan game Google Play untuk game Android Anda. Konsol Google Play menyediakan tempat terpusat bagi Anda untuk mengelola layanan game dan mengonfigurasi metadata untuk memberi otorisasi serta mengautentikasi game.

Untuk menambahkan game ke Konsol Google Play, ikuti langkah-langkah umum berikut:

  • Buat project game untuk game Anda dan tentukan detail seperti nama dan deskripsi game.
  • Buat dan tautkan kredensial yang diperlukan untuk memberi otorisasi dan mengautentikasi game Anda ke Layanan game Google Play.

Langkah ini dibahas lebih detail di bagian di bawah ini.

Langkah 1. Login ke Konsol Google Play

Untuk login, buka Konsol Google Play. Jika belum pernah mendaftar ke Konsol Google Play, Anda akan diminta untuk melakukannya.

Langkah 2: Menambahkan game Anda ke Konsol Google Play

Untuk menambahkan game, ikuti langkah-langkah berikut:

  1. Buat game di Konsol Play jika Anda belum melakukannya. Lihat di sini untuk mengetahui detail selengkapnya.
  2. Buka Grow > Play Games Services > Setup and management > Konfigurasi.
  3. Tentukan project layanan game Play yang ingin Anda gunakan, buat dari awal, atau pilih untuk menggunakan project yang sudah ada.

    • Buat project layanan game Play baru: Untuk membuat project layanan Play Game, project cloud diperlukan.

      • Jika Anda sudah membuat project cloud untuk game ini, pilih project cloud dari daftar dropdown, lalu pilih Use.

      • Atau, pilih Buat project cloud baru, ikuti petunjuk untuk membuat project cloud baru untuk game ini. Kemudian, pilih Refresh cloud projects, pilih project cloud yang baru dibuat dari menu dropdown, lalu klik Use.

    • Gunakan project layanan game Play yang sudah ada: Jika membuat game baru di Konsol Play untuk mengubah nama paket yang ada, atau jika memiliki versi gratis dan berbayar dari game dengan nama paket yang berbeda, Anda dapat menggunakan opsi ini. Pilih project layanan game Play, lalu klik Use.

  4. Project game Layanan game Play dibuat, dan API Layanan game Play otomatis diaktifkan di project cloud yang dipilih.

  5. Di bagian Properties, Anda dapat memilih Edit Properties dan menambahkan deskripsi, kategori, dan aset visual untuk game Anda.

    • Hanya nama tampilan yang diperlukan untuk pengujian. Kolom lainnya harus diisi sebelum Anda dapat memublikasikan game.
    • Nama tampilan dan deskripsi game Anda harus cocok dengan yang telah disiapkan untuk listingan Play Store game.
    • Untuk panduan cara membuat aset visual, lihat panduan Google Play untuk Developer dan Panduan Gambar Unggulan Google Play.

Langkah 3. Membuat client ID OAuth 2.0

Game Anda harus memiliki client ID OAuth 2.0 agar dapat diautentikasi dan diberi otorisasi untuk memanggil layanan game Google Play. Untuk menyiapkan kredensial Layanan game Play, yang merupakan pengaitan antara client ID dan game Anda, gunakan Google Cloud Platform untuk membuat client ID. Kemudian, gunakan Konsol Google Play untuk menambahkan kredensial, menautkan client ID ke game Anda.

Untuk petunjuk yang lebih detail, lihat langkah-langkah berikut:

Jika Anda belum mengonfigurasi layar izin OAuth, bagian Credentials akan menampilkan pesan yang meminta Anda untuk mengonfigurasi.

Perintah untuk mengonfigurasi layar izin OAuth

Klik Configure. Tindakan ini akan membuka dialog yang berisi petunjuk lebih lanjut dan deep link ke Google Cloud Platform.

Konfigurasikan layar izin OAuth Anda. Mengonfigurasi dan memublikasikan halaman penyiapan layar izin OAuth Anda di platform Google Cloud. 1. Buka halaman penyiapan layar izin OAuth di Google Cloud Platform. 2. Buat layar izin tersedia untuk semua orang di Google Play (secara eksternal), atau hanya untuk orang di organisasi Anda (secara internal). 3. Berikan nama aplikasi - nama ini harus cocok dengan nama game Anda di Konsol Play. 4. Tambahkan cakupan: game, game_lite, dan drive.appdata. 5. Publikasikan layar izin Anda. 6. Kembali ke Konsol Play untuk mengonfirmasi konfigurasi.

Jika Anda telah menyelesaikan penyiapan layar izin OAuth, klik Done. Konsol Google Play otomatis dimuat ulang, dan jika konfigurasi berhasil, Anda akan dapat membuat kredensial:

Membuat kredensial

b. Membuat kredensial

Untuk mengizinkan game berkomunikasi dengan layanan game Google Play, Anda harus membuat kredensial dengan client ID OAuth2 yang diotorisasi.

Di bagian Kredensial, klik Add credential.

Di wizard, pilih apakah Anda ingin membuat kredensial Android (jika APK game Anda akan mengautentikasi pengguna dan menggunakan PGS API) atau kredensial server game (jika server game Anda akan menggunakan PGS API). Ikuti petunjuk khusus untuk jenis kredensial yang Anda inginkan.

Android

Menyiapkan detail kredensial

Pastikan nama di kolom Name cocok dengan nama game Anda. Pilih apakah akan mengaktifkan Anti-Pembajakan.

Menyiapkan otorisasi

Selanjutnya, pilih client ID OAuth yang akan digunakan untuk project game ini. Jika sudah memiliki client ID OAuth2, Anda dapat memilih salah satunya. Namun, biasanya Anda akan membuat yang baru. Klik Create OAuth client. Tindakan ini akan membuka dialog yang berisi deep link dan petunjuk untuk membuat Client ID OAuth di Google Cloud Platform.

  1. Pilih Android sebagai jenis aplikasi.
  2. Masukkan nama game Anda di kolom Name.
  3. Masukkan nama paket aplikasi Android Anda di kolom Package name.
  4. Buka terminal dan jalankan utilitas Keytool untuk mendapatkan sidik jari SHA1 sertifikat rilis dan debug.

    Untuk mendapatkan sidik jari sertifikat rilis, jalankan perintah berikut:

    keytool -list -keystore <path-to-production-keystore> -v

    Untuk mendapatkan sidik jari sertifikat debug, jalankan perintah berikut:

    keytool -list -keystore <path-to-debug-keystore> -v

  5. Utilitas keytool meminta Anda untuk memasukkan kata sandi untuk keystore. Kata sandi default untuk keystore debug adalah android. Keytool kemudian mencetak sidik jari ke terminal.

  6. Tempel sidik jari SHA1 ke kolom Signing certificate fingerprint (SHA1).

  7. Klik Create.

Untuk informasi OAuth 2.0 di Android selengkapnya, lihat Mengautentikasi ke Layanan OAuth2.

Setelah Anda mengklik Done pada dialog, Client ID yang tersedia akan dimuat ulang. Pilih kredensial yang Anda buat dari menu drop-down, lalu klik Save Changes. Tindakan ini akan membuat kredensial sebagai draf sehingga Anda dapat mengautentikasi ke Layanan game Play dalam game Anda.

Anda mungkin ingin membuat dua kredensial: satu dengan sidik jari sertifikat rilis, dan satu lagi dengan sidik jari sertifikat debug. Pastikan untuk menggunakan nama paket yang sama untuk keduanya. Hal ini memungkinkan Layanan game Google Play mengenali panggilan dari APK tertaut yang ditandatangani dengan sertifikat. Untuk informasi penandatanganan sertifikat Android selengkapnya, lihat Menandatangani aplikasi.

Server game

Menyiapkan detail kredensial

Pastikan nama di kolom Name cocok dengan nama game Anda.

Menyiapkan otorisasi

Selanjutnya, pilih client ID OAuth yang akan digunakan untuk project game ini. Jika sudah memiliki client ID OAuth2, Anda dapat memilih salah satunya. Namun, biasanya Anda akan membuat yang baru. Klik Create OAuth client. Tindakan ini akan membuka dialog yang berisi deep link dan petunjuk untuk membuat Client ID OAuth di Google Cloud Platform.

  1. Pilih Web application sebagai jenis aplikasi.
  2. Masukkan nama game Anda di kolom Name.
  3. Klik Create.

Untuk informasi OAuth 2.0 di Android selengkapnya, lihat Mengautentikasi ke Layanan OAuth2.

Setelah Anda mengklik Done pada dialog, Client ID yang tersedia akan dimuat ulang. Pilih kredensial yang Anda buat dari menu drop-down, lalu klik Save Changes. Tindakan ini akan membuat kredensial sebagai draf, sehingga Anda dapat mengautentikasi ke Layanan game Play dari server game Anda. Untuk informasi selengkapnya tentang penggunaan Layanan game Play dengan server game, lihat Mengaktifkan Akses Sisi Server ke Layanan game Google Play.

Menghindari masalah penyiapan umum

Untuk menghindari kesalahan penyiapan umum, pastikan untuk mengikuti rekomendasi ini saat menyiapkan game Anda untuk menggunakan layanan game Google Play.

1. Menyiapkan game Anda dengan Konsol Google Play
Jika Anda membuat client ID Oauth 2.0 untuk aplikasi di Konsol Google Cloud, layanan game Google Play tidak akan mengetahui keterkaitan antara pencapaian game, papan peringkat, dan client ID. Untuk membuat pengaitan ini, Anda harus membuat kredensial menggunakan client ID Oauth 2.0 seperti yang dijelaskan dalam Membuat kredensial.
2. Menggunakan ID aplikasi yang benar di Android
ID aplikasi adalah resource string yang diperlukan yang harus Anda referensikan dalam manifes Android. String ID aplikasi hanya terdiri dari angka (biasanya 12 atau lebih) di awal client ID yang diberikan oleh Konsol Google Play. ID aplikasi dapat ditemukan di bagian atas halaman Konfigurasi dan diberi label sebagai ID Project di bawah nama game Anda.
3. Menandatangani APK dengan sertifikat yang benar
Saat menautkan aplikasi Android ke game di Konsol Google Play, Anda harus menggunakan nama paket dan sidik jari sertifikat yang sama persis dengan yang digunakan untuk memublikasikan aplikasi. Jika ada ketidakcocokan, panggilan ke layanan game Google Play akan gagal. Anda harus membuat dua client ID, satu dengan sidik jari sertifikat rilis dan satu lagi dengan sidik jari sertifikat debug, serta menggunakan nama paket yang sama untuk keduanya. Untuk mempelajari lebih lanjut cara menentukan sertifikat penandatanganan di Konsol Google Play, lihat Menandatangani Aplikasi Anda.
4. Saat mengembangkan untuk Android, sertakan Play Game SDK sebagai project library, bukan sebagai JAR mandiri
Pastikan SDK layanan Google Play dirujuk sebagai project library dalam project Android Anda. Jika tidak, hal ini dapat menyebabkan error saat aplikasi Anda tidak dapat menemukan resource layanan Google Play. Untuk mempelajari cara menyiapkan project Android Anda untuk menggunakan layanan Google Play, lihat Menyiapkan Layanan Google Play.
5. Login dengan akun penguji selama pengembangan
Jika belum memublikasikan perubahan setelan game di Konsol Google Play, Anda mungkin akan mengalami error selama pengujian jika tidak login dengan akun penguji yang diizinkan. Anda harus selalu mengaktifkan akun penerbit Konsol Google Play untuk pengujian. Untuk mempelajari cara mengelola akun penguji, lihat Mengaktifkan akun untuk pengujian.
6. Publikasikan layar izin di Google Cloud Platform
Sebelum memublikasikan aplikasi di Konsol Google Play, publikasikan layar izin di Google Cloud Platform. Tanpa langkah ini, audiens publik tidak akan dapat menggunakan fitur Layanan game Play apa pun.
7. Saat perilisan, publikasikan setelan Layanan game Play terlebih dahulu sebelum memublikasikan game
Developer mungkin tidak sengaja memublikasikan aplikasi tanpa memublikasikan setelan layanan game Google Play yang sesuai untuk aplikasi mereka. Hal ini dapat menyebabkan pemain yang login dengan akun non-penguji mengalami error karena aplikasi tidak dapat merujuk ke setelan game yang benar. Saat merilis game, jangan lupa untuk memublikasikan setelan game Anda terlebih dahulu menggunakan opsi Publikasikan Game di Konsol Google Play. Untuk mempelajari cara memublikasikan perubahan, lihat Memublikasikan perubahan game.

Untuk tips tambahan, lihat:

Langkah berikutnya

Sebelum melanjutkan, Anda harus menambahkan akun pengujian ke game seperti yang dijelaskan dalam Mengaktifkan akun untuk pengujian. Pengguna dengan akun pengujian resmi akan memiliki akses ke project game Layanan game Play yang tidak dipublikasikan dan dapat menguji apakah layanan game Google Play yang dikonfigurasi berfungsi dengan benar.

Setelah menyelesaikan tugas penyiapan awal yang dijelaskan di atas, Anda dapat melanjutkan mengonfigurasi fitur untuk game, seperti papan peringkat dan pencapaian. Untuk mempelajari lebih lanjut, lihat Mengaktifkan fitur.