Google Play Game Services

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

Layanan: games.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: achievements

Metode
increment POST /games/v1/achievements/{achievementId}/increment
Menambahkan langkah pencapaian dengan ID yang diberikan untuk pemain yang saat ini diautentikasi.
list GET /games/v1/players/{playerId}/achievements
Mencantumkan progres semua pencapaian aplikasi 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 sudah diautentikasi.

Resource REST: aplikasi

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 diautentikasi sedang memutar aplikasi Anda.
verify GET /games/v1/applications/{applicationId}/verify
Memverifikasi token autentikasi yang diberikan bersama permintaan ini adalah untuk aplikasi yang memiliki ID yang ditentukan, dan menampilkan ID pemain yang diberikan.

Resource REST: events

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
Mencatat sekumpulan perubahan terkait berapa kali peristiwa telah 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 diberikan.
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}
Mencantumkan 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 diberikan.
getMultipleApplicationPlayerIds GET /games/v1/players/me/multipleApplicationPlayerIds
Dapatkan 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 tercakup untuk pengguna yang saat ini diautentikasi.
list GET /games/v1/players/me/players/{collection}
Mendapatkan koleksi pemain untuk pengguna yang saat ini sudah diautentikasi.

Resource REST: recall

Metode
linkPersona POST /games/v1/recall:linkPersona
Mengaitkan utama Pemain PGS yang dienkode dalam ID sesi recall yang disediakan 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}
Mengambil semua token Recall yang terkait dengan akun utama Pemain PGS yang dienkode dalam ID sesi recall yang diberikan.
unlinkPersona POST /games/v1/recall:unlinkPersona
Menghapus token Recall yang menautkan akun utama Pemain PGS yang diidentifikasi oleh sesi Recall dan akun dalam game yang diidentifikasi oleh 'persona' atau 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 di sekitar (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: stats

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