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 Anda menggunakan 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 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: accesstokens

Metode
generatePlayGroupingApiToken
POST /games/v1/accesstokens/generatePlayGroupingApiToken Menghasilkan token Play Grouping API untuk pengguna PGS yang diidentifikasi oleh kredensial yang dilampirkan.
generateRecallPlayGroupingApiToken
POST /games/v1/accesstokens/generateRecallPlayGroupingApiToken Menghasilkan 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: pencapaian

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 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 Menyetel 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: 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 Tunjukkan bahwa pengguna yang saat ini diautentikasi sedang memainkan 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 diberikan.

Resource REST: events

Metode
listByPlayer
GET /games/v1/events Menampilkan daftar yang menunjukkan 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 jumlah berapa kali peristiwa terjadi untuk pengguna yang saat ini diautentikasi oleh aplikasi ini.

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} 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 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 terbatas untuk pengguna yang saat ini diautentikasi.
list
GET /games/v1/players/me/players/{collection} Dapatkan kumpulan pemain untuk pengguna yang saat ini diautentikasi.

Resource REST: recall

Metode
gamesPlayerTokens
GET /games/v1/recall/gamesPlayerTokens/{sessionId} Ambil token Recall dari semua game yang diminta yang dikaitkan 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 dikaitkan dengan Pemain PGS yang dienkode dalam ID sesi recall yang diberikan.
linkPersona
POST /games/v1/recall:linkPersona Mengaitkan utama Pemain PGS yang dienkode dalam ID sesi penarikan kembali 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 Pemutar 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 dengan nilai token.

Resource REST: revisi

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

Resource REST: scores

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 bagian 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 Mengirim skor ke papan peringkat yang ditentukan.
submitMultiple
POST /games/v1/leaderboards/scores Mengirim 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 pemutar yang sesuai dengan ID pemutar.

Resource REST: stats

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