- Permintaan HTTP
- Parameter lokasi
- Parameter kueri
- Isi permintaan
- Isi respons
- Cakupan otorisasi
- ScoreTimeSpan
- IncludeRankType
- Cobalah!
Dapatkan skor tinggi, dan peringkat secara opsional, di papan peringkat untuk pemain yang saat ini diautentikasi. Untuk rentang waktu tertentu, leaderboardId
dapat disetel ke ALL
guna mengambil data untuk semua papan peringkat dalam rentang waktu tertentu. `CATATAN: Anda tidak dapat meminta papan peringkat 'SEMUA' dan 'SEMUA' timeSpan dalam permintaan yang sama; hanya satu parameter yang dapat disetel ke 'SEMUA'.
Permintaan HTTP
GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}
Parameter jalur
Parameter | |
---|---|
playerId |
ID pemain. Nilai |
leaderboardId |
ID papan peringkat. Dapat disetel ke 'SEMUA' guna mengambil data untuk semua papan peringkat untuk aplikasi ini. |
timeSpan |
Rentang waktu untuk skor dan peringkat yang Anda minta. |
Parameter kueri
Parameter | |
---|---|
language |
Bahasa yang dipilih untuk digunakan untuk string yang ditampilkan oleh metode ini. |
includeRankType |
Jenis peringkat yang akan ditampilkan. Jika parameter dihilangkan, tidak ada peringkat yang akan ditampilkan. |
maxResults |
Jumlah skor papan peringkat maksimum untuk ditampilkan dalam respons. Untuk respons apa pun, jumlah skor papan peringkat sebenarnya yang ditampilkan mungkin kurang dari |
pageToken |
Token yang ditampilkan oleh permintaan sebelumnya. |
Isi permintaan
Isi permintaan harus kosong.
Isi respons
Jika berhasil, isi respons akan berisi instance GetLeaderboardScoresResponse
.
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.
ScoreTimeSpan
Menentukan kemungkinan rentang waktu untuk skor.
Enum | |
---|---|
ALL |
Dapatkan skor tertinggi untuk semua rentang waktu. Jika ini digunakan, nilai maxResults akan diabaikan. |
ALL_TIME |
Mendapatkan skor tertinggi sepanjang masa. |
WEEKLY |
Cantumkan skor tertinggi untuk hari ini. |
DAILY |
Cantumkan skor tertinggi untuk minggu ini. |
IncludeRankType
Nilai yang mungkin untuk jenis peringkat.
Enum | |
---|---|
ALL |
Ambil semua peringkat yang didukung. Di HTTP, nilai parameter ini juga dapat ditentukan sebagai ALL . |
PUBLIC |
Mengambil peringkat publik, jika pemain membagikan aktivitas gameplay mereka secara publik. |
SOCIAL |
(Usang) Ambil peringkat sosial. |
FRIENDS |
Ambil peringkat di koleksi teman. |