Halaman ini diterjemahkan oleh Cloud Translation API.

Scores: list

Mencantumkan skor di papan peringkat, mulai dari atas. Coba sekarang.

Permintaan

Permintaan HTTP

GET https://www.googleapis.com/games/v1/leaderboards/leaderboardId/scores/collection

Parameter

Nama parameter	Nilai	Deskripsi
Parameter jalur
`collection`	`string`	Kumpulan skor yang Anda minta. Nilai yang dapat diterima adalah: "`FRIENDS`": Hanya mencantumkan skor teman. "`PUBLIC`": Mencantumkan semua skor di papan peringkat publik. "`SOCIAL`": (Obsolete) Skor sosial G+ lama. Gunakan koleksi TEMAN sebagai gantinya.
`leaderboardId`	`string`	ID papan peringkat.
Parameter kueri yang diperlukan
`timeSpan`	`string`	Rentang waktu untuk skor dan peringkat yang Anda minta. Nilai yang dapat diterima adalah: "`ALL_TIME`": Mencantumkan skor teratas sepanjang waktu. "`DAILY`": Mencantumkan skor teratas untuk hari ini. "`WEEKLY`": Mencantumkan skor teratas untuk minggu ini.
Parameter kueri opsional
`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 akan menampilkan isi respons dengan struktur berikut:

{
  "kind": "games#leaderboardScores",
  "nextPageToken": string,
  "prevPageToken": string,
  "numScores": long,
  "playerScore": {
    "kind": "games#leaderboardEntry",
    "player": players Resource,
    "scoreRank": long,
    "formattedScoreRank": string,
    "scoreValue": long,
    "formattedScore": string,
    "timeSpan": string,
    "writeTimestampMillis": long,
    "scoreTag": string
  },
  "items": [
    {
      "kind": "games#leaderboardEntry",
      "player": players Resource,
      "scoreRank": long,
      "formattedScoreRank": string,
      "scoreValue": long,
      "formattedScore": string,
      "timeSpan": string,
      "writeTimestampMillis": long,
      "scoreTag": string
    }
  ]
}

Nama properti	Nilai	Deskripsi
`kind`	`string`	Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap `games#leaderboardScores`.
`nextPageToken`	`string`	Token penomoran halaman untuk halaman hasil berikutnya.
`prevPageToken`	`string`	Token penomoran halaman untuk halaman hasil sebelumnya.
`numScores`	`long`	Jumlah total skor di papan peringkat.
`playerScore`	`nested object`	Skor pemain yang meminta di papan peringkat. Skor pemain dapat muncul di sini dan dalam daftar skor di atas. Jika Anda melihat papan peringkat publik dan pemain tidak berbagi informasi gameplay secara publik, nilai `scoreRank` dan `formattedScoreRank` tidak akan ada.
`playerScore.kind`	`string`	Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap `games#leaderboardEntry`.
`playerScore.player`	`nested object`	Pemain yang memegang skor ini.
`playerScore.scoreRank`	`long`	Peringkat skor ini untuk papan peringkat ini.
`playerScore.formattedScoreRank`	`string`	String yang dilokalkan untuk peringkat skor ini untuk papan peringkat ini.
`playerScore.scoreValue`	`long`	Nilai numerik skor ini.
`playerScore.formattedScore`	`string`	String yang dilokalkan untuk nilai numerik skor ini.
`playerScore.timeSpan`	`string`	Rentang waktu skor tertinggi ini. Nilai yang memungkinkan adalah: "`ALL_TIME`" - Skornya adalah skor tertinggi sepanjang masa. "`WEEKLY`" - Skornya adalah skor tertinggi mingguan. "`DAILY`" - Skor adalah skor tertinggi harian. Nilai yang dapat diterima adalah: "`ALL_TIME`" "`DAILY`" "`WEEKLY`"
`playerScore.writeTimestampMillis`	`long`	Stempel waktu saat skor ini dicatat, dalam milidetik sejak epoch dalam UTC.
`playerScore.scoreTag`	`string`	Informasi tambahan tentang skor. Nilai tidak boleh berisi lebih dari 64 karakter yang aman untuk URI seperti yang ditetapkan dalam bagian 2.3 RFC 3986.
`items[]`	`list`	Skor di papan peringkat.
`items[].kind`	`string`	Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap `games#leaderboardEntry`.
`items[].player`	`nested object`	Pemain yang memegang skor ini.
`items[].scoreRank`	`long`	Peringkat skor ini untuk papan peringkat ini.
`items[].formattedScoreRank`	`string`	String yang dilokalkan untuk peringkat skor ini untuk papan peringkat ini.
`items[].scoreValue`	`long`	Nilai numerik skor ini.
`items[].formattedScore`	`string`	String yang dilokalkan untuk nilai numerik skor ini.
`items[].timeSpan`	`string`	Rentang waktu skor tertinggi ini. Nilai yang memungkinkan adalah: "`ALL_TIME`" - Skornya adalah skor tertinggi sepanjang masa. "`WEEKLY`" - Skornya adalah skor tertinggi mingguan. "`DAILY`" - Skor adalah skor tertinggi harian. Nilai yang dapat diterima adalah: "`ALL_TIME`" "`DAILY`" "`WEEKLY`"
`items[].writeTimestampMillis`	`long`	Stempel waktu saat skor ini dicatat, dalam milidetik sejak epoch dalam UTC.
`items[].scoreTag`	`string`	Informasi tambahan tentang skor. Nilai tidak boleh berisi lebih dari 64 karakter yang aman untuk URI seperti yang ditetapkan dalam bagian 2.3 RFC 3986.

Cobalah!

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