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
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. |
Metode |
list |
GET /games/v1/achievements
Mencantumkan semua definisi pencapaian untuk aplikasi Anda. |
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. |
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. |
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: 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. |
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. |