Scores: submit

Mengirim skor ke papan peringkat yang ditentukan. Coba sekarang.

Permintaan

Permintaan HTTP

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

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
leaderboardId string ID papan peringkat.
Parameter kueri yang diperlukan
score long Skor yang Anda kirimkan. Skor yang dikirimkan akan diabaikan jika skor tersebut lebih buruk daripada skor yang dikirimkan sebelumnya, dengan skor lebih bergantung pada tata urutan papan peringkat. Arti nilai skor bergantung pada jenis format papan peringkat. Untuk titik tetap, skor mewakili nilai mentah. Untuk waktu, skor mewakili waktu yang berlalu dalam milidetik. Untuk mata uang, skor mewakili nilai dalam unit mikro.
Parameter kueri opsional
language string Bahasa pilihan untuk digunakan dalam string yang ditampilkan oleh metode ini.
scoreTag string Informasi tambahan tentang skor yang Anda kirimkan. Nilai tidak boleh berisi lebih dari 64 karakter yang aman untuk URI seperti yang ditetapkan dalam bagian 2.3 RFC 3986.

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#playerScoreResponse",
  "beatenScoreTimeSpans": [
    string
  ],
  "unbeatenScores": [
    {
      "kind": "games#playerScore",
      "timeSpan": string,
      "score": long,
      "formattedScore": string,
      "scoreTag": string
    }
  ],
  "formattedScore": string,
  "leaderboardId": string,
  "scoreTag": string
}
Nama properti Nilai Deskripsi Catatan
kind string Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#playerScoreResponse.
beatenScoreTimeSpans[] list Rentang waktu saat skor yang dikirimkan lebih baik daripada skor yang ada untuk rentang waktu tersebut.
Nilai yang memungkinkan adalah:
  • "ALL_TIME" - Skor adalah skor sepanjang waktu.
  • "WEEKLY" - Skornya adalah skor mingguan.
  • "DAILY" - Skor adalah skor harian.
unbeatenScores[] list Skor dalam rentang waktu yang belum dikalahkan. Misalnya, skor yang dikirimkan mungkin lebih baik daripada skor DAILY pemain, tetapi tidak lebih baik daripada skor pemain untuk rentang waktu WEEKLY atau ALL_TIME.
unbeatenScores[].kind string Secara unik mengidentifikasi jenis resource ini. Nilai selalu berupa string tetap games#playerScore.
unbeatenScores[].timeSpan string Rentang waktu untuk skor pemain ini.
Nilai yang memungkinkan adalah:
  • "ALL_TIME" - Skor adalah skor sepanjang waktu.
  • "WEEKLY" - Skornya adalah skor mingguan.
  • "DAILY" - Skor adalah skor harian.


Nilai yang dapat diterima adalah:
  • "ALL_TIME"
  • "DAILY"
  • "WEEKLY"
unbeatenScores[].score long Nilai numerik untuk skor pemain ini.
unbeatenScores[].formattedScore string Skor yang diformat untuk skor pemain ini.
unbeatenScores[].scoreTag string Informasi tambahan tentang skor ini. Nilai tidak akan berisi lebih dari 64 karakter aman URI seperti yang ditentukan oleh bagian 2.3 dari RFC 3986.
formattedScore string Nilai terformat dari skor yang dikirimkan.
leaderboardId string ID papan peringkat yang menjadi tujuan pengiriman skor ini.
scoreTag string Informasi tambahan tentang skor ini. Nilai tidak akan berisi lebih dari 64 karakter aman URI seperti yang ditentukan oleh bagian 2.3 dari RFC 3986.

Cobalah!

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