Scores: get

Dapatkan skor tinggi, dan secara opsional, peringkat, di papan peringkat untuk pemain yang saat ini diautentikasi. Untuk rentang waktu tertentu, leaderboardId dapat disetel ke ALL untuk mengambil data 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 ditetapkan ke 'SEMUA'. Coba sekarang.

Permintaan

Permintaan HTTP

GET https://www.googleapis.com/games/v1/players/playerId/leaderboards/leaderboardId/scores/timeSpan

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
leaderboardId string ID papan peringkat. Dapat disetel ke 'ALL' untuk mengambil data semua papan peringkat untuk aplikasi ini.
playerId string ID pemain. Nilai me dapat digunakan sebagai pengganti ID pemain yang diautentikasi.
timeSpan string Rentang waktu untuk skor dan peringkat yang Anda minta.

Nilai yang dapat diterima adalah:
  • "ALL": Mendapatkan skor tertinggi untuk semua rentang waktu. Jika ini digunakan, nilai maxResults akan diabaikan.
  • "ALL_TIME": Mendapatkan skor tertinggi sepanjang waktu.
  • "DAILY": Mencantumkan skor teratas untuk hari ini.
  • "WEEKLY": Mencantumkan skor teratas untuk minggu ini.
Parameter kueri opsional
includeRankType string Jenis peringkat yang akan ditampilkan. Jika parameter dihilangkan, tidak ada peringkat yang akan ditampilkan.

Nilai yang dapat diterima adalah:
  • "ALL": Mengambil semua peringkat yang didukung.
  • "FRIENDS": Ambil peringkat di koleksi teman.
  • "PUBLIC": Mengambil peringkat publik, jika pemain membagikan aktivitas gameplay mereka secara publik.
  • "SOCIAL": (Tidak digunakan lagi) Papan peringkat sosial G+ lama, selalu 1.
language string Bahasa pilihan untuk digunakan dalam string yang ditampilkan oleh metode ini.
maxResults integer Jumlah maksimum skor papan peringkat yang akan ditampilkan dalam respons. Untuk respons apa pun, jumlah skor papan peringkat yang sebenarnya mungkin ditampilkan kurang dari maxResults yang ditentukan. Nilai yang dapat diterima adalah 1 hingga 30, inklusif.
pageToken string Token yang ditampilkan oleh permintaan sebelumnya.

Otorisasi

Permintaan ini memerlukan otorisasi dengan cakupan berikut:

Cakupan
https://www.googleapis.com/auth/games

Untuk informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Jangan berikan isi permintaan dengan metode ini.

Tanggapan

Jika berhasil, metode ini menampilkan Resource skor dalam isi respons.

Cobalah!

Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan lihat responsnya.