Method: scores.get

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

string

ID pemain. Nilai me dapat digunakan sebagai pengganti ID pemain yang diautentikasi.
leaderboardId

string

ID papan peringkat. Dapat disetel ke 'SEMUA' guna mengambil data untuk semua papan peringkat untuk aplikasi ini.
timeSpan

enum (ScoreTimeSpan)

Rentang waktu untuk skor dan peringkat yang Anda minta.

Parameter kueri

Parameter
language

string

Bahasa yang dipilih untuk digunakan untuk string yang ditampilkan oleh metode ini.
includeRankType

enum (IncludeRankType)

Jenis peringkat yang akan ditampilkan. Jika parameter dihilangkan, tidak ada peringkat yang akan ditampilkan.
maxResults

integer

Jumlah skor papan peringkat maksimum untuk ditampilkan dalam respons. Untuk respons apa pun, jumlah skor papan peringkat sebenarnya yang ditampilkan mungkin kurang dari maxResults yang ditentukan.
pageToken

string

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.