Google Play Games Services API

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 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

REST Resource: accesstokens

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

REST Resource: achievementDefinitions

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

REST Resource: achievements

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 untuk pemain yang saat ini diautentikasi dalam 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.

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

REST Resource: 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 serangkaian perubahan pada jumlah peristiwa yang terjadi untuk pengguna aplikasi 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.

REST Resource: metagame

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

REST Resource: playerGameEvents

Metode
batchRecordEvents POST /games/v1/players/{playerId}/gameEvents:batchRecordEvents
Mencatat batch peristiwa game pemain untuk pemain tertentu.

REST Resource: players

Metode
get GET /games/v1/players/{playerId}
Mengambil resource Player 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 yang tercakup untuk pengguna yang saat ini diautentikasi.
list GET /games/v1/players/me/players/{collection}
Mendapatkan 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 dan terkait dengan Pemain PGS 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 Pemain PGS yang dienkode dalam ID sesi recall yang diberikan.
linkPersona POST /games/v1/recall:linkPersona
Mengaitkan akun utama Pemain PGS 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 Pemain PGS yang dienkode dalam ID sesi recall yang diberikan.
unlinkPersona POST /games/v1/recall:unlinkPersona
Menghapus token Recall yang menautkan pokok Pemain PGS yang diidentifikasi oleh sesi Recall dan akun dalam game yang diidentifikasi oleh 'persona' atau nilai token.

REST Resource: revisions

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

REST Resource: 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 dalam papan peringkat, dimulai dari yang tertinggi.
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.

REST Resource: 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.

REST Resource: stats

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