Method: scores.get

Dapatkan skor tertinggi, dan secara opsional peringkat, di papan peringkat untuk pemain yang saat ini diautentikasi. Untuk jangka waktu tertentu, leaderboardId dapat ditetapkan ke ALL untuk mengambil data untuk semua papan peringkat dalam jangka waktu tertentu. `CATATAN: Anda tidak dapat meminta papan peringkat 'ALL' dan timeSpan 'ALL' dalam permintaan yang sama; hanya satu parameter yang dapat ditetapkan ke 'ALL'.

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 ditetapkan ke 'ALL' untuk 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 lebih disukai 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 maksimum skor papan peringkat yang akan ditampilkan dalam respons. Untuk respons apa pun, jumlah skor papan peringkat yang 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 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 digunakan, nilai maxResults akan diabaikan.
ALL_TIME Dapatkan skor tertinggi sepanjang masa.
WEEKLY Cantumkan skor teratas untuk hari ini.
DAILY Cantumkan skor teratas untuk minggu ini.

IncludeRankType

Kemungkinan nilai untuk jenis peringkat.

Enum
ALL Mengambil semua peringkat yang didukung. Di HTTP, nilai parameter ini juga dapat ditentukan sebagai ALL.
PUBLIC Mengambil peringkat publik, jika pemain membagikan aktivitas gameplay-nya secara publik.
SOCIAL

(Tidak digunakan lagi) Mengambil peringkat sosial.
FRIENDS Mengambil peringkat di koleksi teman.