REST Resource: scores

แหล่งข้อมูล: GetLeaderboardScoresResponse

รายการคะแนนในลีดเดอร์บอร์ดของผู้เล่น

การแสดง JSON 
{
  "kind": string,
  "nextPageToken": string,
  "player": {
    object (Player)
  },
  "items": [
    {
      object (LeaderboardScore)
    }
  ]
}
ช่อง
kind

string

ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ games#playerLeaderboardScoreListResponse เสมอ
nextPageToken

string

โทเค็นการแบ่งหน้าสำหรับหน้าผลการค้นหาถัดไป
player

object (Player)

แหล่งข้อมูลของผู้เล่นสำหรับเจ้าของคะแนนนี้
items[]

object (LeaderboardScore)

คะแนนในลีดเดอร์บอร์ด

LeaderboardScore

ออบเจ็กต์คะแนนลีดเดอร์บอร์ดของผู้เล่น

การแสดง JSON 
{
  "kind": string,
  "leaderboard_id": string,
  "scoreValue": string,
  "scoreString": string,
  "publicRank": {
    object (LeaderboardScoreRank)
  },
  "socialRank": {
    object (LeaderboardScoreRank)
  },
  "friendsRank": {
    object (LeaderboardScoreRank)
  },
  "timeSpan": enum (ScoreTimeSpan),
  "writeTimestamp": string,
  "scoreTag": string
}
ช่อง
kind

string

ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ games#playerLeaderboardScore เสมอ
leaderboard_id

string

รหัสของลีดเดอร์บอร์ดที่มีคะแนนนี้
scoreValue

string (int64 format)

ค่าตัวเลขของคะแนนนี้
scoreString

string

ค่าการจัดรูปแบบของคะแนนนี้
publicRank

object (LeaderboardScoreRank)

อันดับสาธารณะของคะแนนในลีดเดอร์บอร์ดนี้ ออบเจ็กต์นี้จะไม่ปรากฏหากผู้ใช้ไม่ได้แชร์คะแนนแบบสาธารณะ
socialRank

object (LeaderboardScoreRank)

อันดับโซเชียลของคะแนนในลีดเดอร์บอร์ดนี้
friendsRank

object (LeaderboardScoreRank)

อันดับของคะแนนในคอลเล็กชันเพื่อนสำหรับลีดเดอร์บอร์ดนี้
timeSpan

enum (ScoreTimeSpan)

ระยะเวลาของคะแนนนี้
writeTimestamp

string (int64 format)

การประทับเวลาที่มีการบันทึกคะแนนเป็นมิลลิวินาทีตั้งแต่ Epoch ใน UTC
scoreTag

string

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

LeaderboardScoreRank

คะแนนอยู่ในลีดเดอร์บอร์ด

การแสดง JSON 
{
  "kind": string,
  "rank": string,
  "formattedRank": string,
  "numScores": string,
  "formattedNumScores": string
}
ช่อง
kind

string

ระบุประเภทของทรัพยากรนี้โดยไม่ซ้ำกัน ค่าจะเป็นสตริงคงที่ games#leaderboardScoreRank เสมอ
rank

string (int64 format)

อันดับในลีดเดอร์บอร์ด
formattedRank

string

อันดับในลีดเดอร์บอร์ดเป็นสตริง
numScores

string (int64 format)

จำนวนคะแนนในลีดเดอร์บอร์ด
formattedNumScores

string

จำนวนคะแนนในลีดเดอร์บอร์ดโดยเป็นสตริง

ScoreTimeSpan

ระบุระยะเวลาที่อาจเป็นไปได้สำหรับการให้คะแนน

Enum
ALL_TIME คะแนนนี้เป็นคะแนนตลอดกาล
WEEKLY โดยคะแนนจะเป็นคะแนนรายสัปดาห์
DAILY โดยคะแนนจะเป็นคะแนนรายวัน

วิธีการ

get

 รับคะแนนสูงสุดและจัดอันดับ (ไม่บังคับ) ในลีดเดอร์บอร์ดสำหรับผู้เล่นที่ตรวจสอบสิทธิ์อยู่ในปัจจุบัน

list

 แสดงคะแนนในลีดเดอร์บอร์ด โดยเริ่มจากด้านบนสุด

listWindow

 แสดงคะแนนในลีดเดอร์บอร์ดรอบๆ (และรวม) คะแนนของผู้เล่น

submit

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

submitMultiple

 ส่งคะแนนหลายรายการไปยังลีดเดอร์บอร์ด