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 Anda 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 penemuan berikut:

Endpoint layanan

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

  • https://games.googleapis.com

Resource REST: accesstokens

Metode
generatePlayGroupingApiToken POST /games/v1/accesstokens/generatePlayGroupingApiToken
Membuat token Play Grouping API untuk pengguna PGS yang diidentifikasi oleh kredensial yang dilampirkan.
generateRecallPlayGroupingApiToken POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken
Membuat token Play Grouping API untuk pengguna PGS yang diidentifikasi oleh ID sesi Recall yang diberikan dalam permintaan.

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 untuk semua pencapaian aplikasi Anda bagi 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 untuk pemain yang saat ini diautentikasi guna 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 endpoint 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 dengan permintaan ini untuk aplikasi dengan ID yang ditentukan, dan menampilkan ID pemain yang diberi token tersebut.

Resource REST: events

Metode
listByPlayer GET /games/v1/events
Menampilkan daftar yang menunjukkan progres saat ini 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 pada frekuensi terjadinya peristiwa untuk pengguna aplikasi ini yang saat ini diautentikasi.

REST Resource: leaderboards

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}
Cantumkan data pemutaran yang digabungkan per kategori untuk pemain yang sesuai dengan playerId.

REST Resource: players

Metode
get GET /games/v1/players/{playerId}
Mengambil resource Pemain dengan ID yang diberikan.
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}
Dapatkan kumpulan pemain untuk pengguna yang saat ini diautentikasi.

REST Resource: recall

Metode
gamesPlayerTokens GET /games/v1/recall/gamesPlayerTokens/{sessionId}
Mengambil token Recall dari semua game yang diminta yang terkait dengan PGS Player yang dienkode dalam ID sesi recall yang diberikan.
lastTokenFromAllDeveloperGames GET /games/v1/recall/developerGamesLastPlayerToken/{sessionId}
Mengambil token Recall terakhir dari semua game developer yang terkait dengan PGS Player yang dienkode dalam ID sesi recall yang diberikan.
linkPersona POST /games/v1/recall:linkPersona
Mengaitkan akun utama PGS Player yang dienkode dalam ID sesi recall yang diberikan dengan akun dalam game
resetPersona POST /games/v1/recall:resetPersona
Menghapus 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 PGS Player yang dienkode dalam ID sesi recall yang diberikan.
unlinkPersona POST /games/v1/recall:unlinkPersona
Menghapus token Recall yang menautkan akun PGS Player yang diidentifikasi oleh sesi Recall dan akun dalam game yang diidentifikasi oleh 'persona' atau oleh nilai token.

REST Resource: revisions

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

Resource REST: scores

Metode
get GET /games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Mendapatkan skor tertinggi, dan secara opsional peringkat, 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: snapshots

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 pemain yang sesuai dengan ID pemain.

Resource REST: stats

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