Method: scores.submit

ส่งคะแนนไปยังลีดเดอร์บอร์ดที่ระบุ

คำขอ HTTP

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

พารามิเตอร์เส้นทาง

พารามิเตอร์
leaderboardId

string

รหัสของลีดเดอร์บอร์ด

พารามิเตอร์การค้นหา

พารามิเตอร์
language

string

ภาษาที่ต้องการใช้สำหรับสตริงที่แสดงผลโดยวิธีนี้

score

string (int64 format)

ต้องระบุ คะแนนที่คุณส่ง ระบบจะไม่สนใจคะแนนที่ส่งไปหากคะแนนนั้นแย่กว่าคะแนนที่ส่งไปก่อนหน้านี้ ส่วนคะแนนที่แย่กว่าจะขึ้นอยู่กับลำดับการจัดเรียงลีดเดอร์บอร์ด ความหมายของค่าคะแนนจะขึ้นอยู่กับประเภทรูปแบบลีดเดอร์บอร์ด สำหรับจุดตายตัว คะแนนจะแสดงค่าดิบ สำหรับเวลา คะแนนจะแสดงเวลาที่ผ่านไปในหน่วยมิลลิวินาที สำหรับสกุลเงิน คะแนนจะแสดงค่าในหน่วยไมโคร

scoreTag

string

ข้อมูลเพิ่มเติมเกี่ยวกับคะแนนที่คุณส่ง ค่าต้องประกอบด้วยอักขระที่ปลอดภัย URI ไม่เกิน 64 ตัวตามที่กำหนดโดยส่วน 2.3 ของ RFC 3986

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

หากทำสำเร็จ เนื้อหาการตอบกลับจะมีอินสแตนซ์ SubmitLeaderboardScoreResponse

ขอบเขตการให้สิทธิ์

ต้องมีขอบเขต OAuth อย่างใดอย่างหนึ่งต่อไปนี้

  • https://www.googleapis.com/auth/games
  • https://www.googleapis.com/auth/games_lite

ดูข้อมูลเพิ่มเติมได้ที่ภาพรวมของ OAuth 2.0