Google Play Game Services

Layanan game Google Play memungkinkan developer meningkatkan kualitas game dengan papan peringkat sosial, pencapaian, status game, login dengan Google, dan banyak lagi.

Layanan: game.googleapis.com

Untuk memanggil layanan ini, sebaiknya gunakan library klien yang disediakan Google. Jika aplikasi Anda perlu menggunakan library Anda sendiri untuk memanggil layanan ini, gunakan informasi berikut saat membuat permintaan API.

Dokumen discovery

Dokumen Discovery adalah spesifikasi yang dapat dibaca komputer untuk mendeskripsikan dan menggunakan REST API. Dokumen ini digunakan untuk membuat library klien, plugin IDE, dan alat lainnya yang berinteraksi dengan Google API. Satu layanan dapat menyediakan beberapa dokumen discovery. Layanan ini menyediakan dokumen discovery berikut:

Endpoint layanan

Endpoint layanan adalah URL dasar yang menentukan alamat jaringan layanan API. Satu layanan mungkin memiliki beberapa endpoint layanan. Layanan ini memiliki endpoint layanan berikut dan semua URI di bawah berhubungan dengan endpoint layanan ini:

  • https://games.googleapis.com

Resource REST: achievementDefinitions

Metode
list GET /games/v1/achievements
Mencantumkan semua definisi pencapaian untuk aplikasi Anda.

Resource REST: pencapaian

Metode
increment POST /games/v1/achievements/{achievementId}/increment
Menambah langkah-langkah pencapaian dengan ID yang diberikan untuk pemain yang saat ini diautentikasi.
list GET /games/v1/players/{playerId}/achievements
Mencantumkan progres semua pencapaian aplikasi Anda untuk pemain yang saat ini diautentikasi.
reveal POST /games/v1/achievements/{achievementId}/reveal
Menetapkan status pencapaian dengan ID yang diberikan ke REVEALED untuk pemain yang saat ini diautentikasi.
setStepsAtLeast POST /games/v1/achievements/{achievementId}/setStepsAtLeast
Menetapkan langkah-langkah bagi pemain yang saat ini diautentikasi untuk membuka pencapaian.
unlock POST /games/v1/achievements/{achievementId}/unlock
Membuka pencapaian ini untuk pemain yang saat ini diautentikasi.
updateMultiple POST /games/v1/achievements/updateMultiple
Memperbarui beberapa pencapaian untuk pemain yang saat ini diautentikasi.

Resource REST: applications

Metode
get GET /games/v1/applications/{applicationId}
Mengambil metadata aplikasi dengan ID yang diberikan.
getEndPoint POST /games/v1/applications/getEndPoint
Menampilkan URL untuk jenis titik akhir yang diminta.
played POST /games/v1/applications/played
Menunjukkan bahwa pengguna yang saat ini terautentikasi sedang memutar aplikasi Anda.
verify GET /games/v1/applications/{applicationId}/verify
Memverifikasi token autentikasi yang diberikan bersama permintaan ini ditujukan untuk aplikasi yang memiliki ID yang ditentukan, dan menampilkan ID pemain yang diberikan.

Resource REST: peristiwa

Metode
listByPlayer GET /games/v1/events
Menampilkan daftar yang menampilkan progres terkini pada peristiwa di aplikasi ini untuk pengguna yang saat ini diautentikasi.
listDefinitions GET /games/v1/eventDefinitions
Menampilkan daftar definisi peristiwa dalam aplikasi ini.
record POST /games/v1/events
Merekam sekumpulan perubahan terkait berapa kali peristiwa terjadi untuk pengguna aplikasi yang saat ini diautentikasi.

Resource REST: papan peringkat

Metode
get GET /games/v1/leaderboards/{leaderboardId}
Mengambil metadata papan peringkat dengan ID yang ditentukan.
list GET /games/v1/leaderboards
Mencantumkan semua metadata papan peringkat untuk aplikasi Anda.

Resource REST: metagame

Metode
getMetagameConfig GET /games/v1/metagameConfig
Menampilkan data konfigurasi metagame untuk aplikasi panggilan.
listCategoriesByPlayer GET /games/v1/players/{playerId}/categories/{collection}
Daftar data pemutaran yang digabungkan per kategori untuk pemain yang sesuai dengan playerId.

Resource REST: pemain

Metode
get GET /games/v1/players/{playerId}
Mengambil resource Pemain dengan ID yang ditentukan.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Mendapatkan ID pemain aplikasi untuk pemain yang saat ini diautentikasi di semua game yang diminta oleh developer yang sama dengan aplikasi panggilan.
getScopedPlayerIds GET /games/v1/players/me/scopedIds
Mengambil ID pemain cakupan untuk pengguna yang saat ini diautentikasi.
list GET /games/v1/players/me/players/{collection}
Mendapatkan kumpulan pemain untuk pengguna yang saat ini diautentikasi.

Resource REST: perolehan

Metode
linkPersona POST /games/v1/recall:linkPersona
Mengaitkan akun utama Pemain PGS yang dienkode dalam ID sesi ingatan yang diberikan dengan akun dalam game
resetPersona POST /games/v1/recall:resetPersona
Hapus semua token Recall yang menautkan persona tertentu ke pemain mana pun (dengan atau tanpa profil).
retrieveTokens GET /games/v1/recall/tokens/{sessionId}
Ambil semua token Recall yang terkait dengan utama Pemain PGS yang dienkode dalam ID sesi recall yang diberikan.
unlinkPersona POST /games/v1/recall:unlinkPersona
Hapus token Recall yang menautkan akun utama Pemain PGS yang diidentifikasi oleh sesi Recall dan akun dalam game yang diidentifikasi oleh 'persona' atau oleh nilai token.

Resource REST: revisi

Metode
check GET /games/v1/revisions/check
Memeriksa apakah klien game sudah usang.

Resource REST: skor

Metode
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Dapatkan skor tertinggi, dan peringkat secara opsional, di papan peringkat untuk pemain yang saat ini diautentikasi.
list GET /games/v1/leaderboards/{leaderboardId}/scores/{collection}
Mencantumkan skor di papan peringkat, mulai dari atas.
listWindow GET /games/v1/leaderboards/{leaderboardId}/window/{collection}
Mencantumkan skor di papan peringkat terkait (dan termasuk) skor pemain.
submit POST /games/v1/leaderboards/{leaderboardId}/scores
Mengirimkan skor ke papan peringkat yang ditentukan.
submitMultiple POST /games/v1/leaderboards/scores
Mengirimkan beberapa skor ke papan peringkat.

Resource REST: snapshot

Metode
get GET /games/v1/snapshots/{snapshotId}
Mengambil metadata untuk ID snapshot tertentu.
list GET /games/v1/players/{playerId}/snapshots
Mengambil daftar snapshot yang dibuat oleh aplikasi Anda untuk pemutar yang sesuai dengan ID pemain.

Resource REST: statistik

Metode
get GET /games/v1/stats
Menampilkan statistik engagement dan pembelanjaan dalam aplikasi ini untuk pengguna yang saat ini diautentikasi.