REST Resource: scores

Tài nguyên: GetLeaderboardScoresResponse

Danh sách điểm số trên bảng xếp hạng của người chơi.

Biểu diễn dưới dạng JSON
{
  "kind": string,
  "nextPageToken": string,
  "player": {
    object (Player)
  },
  "items": [
    {
      object (LeaderboardScore)
    }
  ]
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#playerLeaderboardScoreListResponse.

nextPageToken

string

Mã phân trang cho trang kết quả tiếp theo.

player

object (Player)

Tài nguyên Người chơi dành cho chủ sở hữu điểm số này.

items[]

object (LeaderboardScore)

Điểm số trên bảng xếp hạng.

LeaderboardScore

Một đối tượng tính điểm trong bảng xếp hạng người chơi.

Biểu diễn dưới dạng 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
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#playerLeaderboardScore.

leaderboard_id

string

Mã của bảng xếp hạng có điểm số này.

scoreValue

string (int64 format)

Giá trị bằng số của điểm số này.

scoreString

string

Giá trị được định dạng của điểm số này.

publicRank

object (LeaderboardScoreRank)

Thứ hạng công khai của điểm số trong bảng xếp hạng này. Đối tượng này sẽ không xuất hiện nếu người dùng không chia sẻ công khai điểm số của họ.

socialRank

object (LeaderboardScoreRank)

Thứ hạng xã hội của điểm số trong bảng xếp hạng này.

friendsRank

object (LeaderboardScoreRank)

Thứ hạng điểm số trong bộ sưu tập bạn bè của bảng xếp hạng này.

timeSpan

enum (ScoreTimeSpan)

Khoảng thời gian của điểm này.

writeTimestamp

string (int64 format)

Dấu thời gian mà điểm này được ghi lại, tính bằng mili giây kể từ thời gian bắt đầu của hệ thống theo giờ UTC.

scoreTag

string

Thông tin bổ sung về điểm số. Giá trị không được chứa quá 64 ký tự an toàn cho URI theo quy định trong mục 2.3 của RFC 3986.

LeaderboardScoreRank

Thứ hạng điểm số trong bảng xếp hạng.

Biểu diễn dưới dạng JSON
{
  "kind": string,
  "rank": string,
  "formattedRank": string,
  "numScores": string,
  "formattedNumScores": string
}
Các trường
kind

string

Xác định duy nhất loại tài nguyên này. Giá trị luôn là chuỗi cố định games#leaderboardScoreRank.

rank

string (int64 format)

Thứ hạng trong bảng xếp hạng.

formattedRank

string

Thứ hạng trong bảng xếp hạng dưới dạng một chuỗi.

numScores

string (int64 format)

Số điểm trong bảng xếp hạng.

formattedNumScores

string

Số điểm trong bảng xếp hạng dưới dạng một chuỗi.

ScoreTimeSpan

Xác định các khoảng thời gian có thể có cho một điểm số.

Enum
ALL_TIME Đây là điểm số từ trước đến nay.
WEEKLY Điểm số này là điểm số tuần.
DAILY Điểm số này là điểm số hằng ngày.

Phương thức

get

Đạt điểm cao và xếp hạng theo tùy chọn trong bảng xếp hạng cho người chơi hiện đã được xác thực.

list

Liệt kê điểm số trong một bảng xếp hạng, bắt đầu từ trên cùng.

listWindow

Liệt kê điểm số trong một bảng xếp hạng xung quanh (và bao gồm) điểm của người chơi.

submit

Gửi điểm số đến bảng xếp hạng đã chỉ định.

submitMultiple

Gửi nhiều điểm số lên bảng xếp hạng.