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)
    }
  ]
}
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 games#playerLeaderboardScoreListResponse cố định.
nextPageToken

string

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

object (Player)

Tài nguyên về người chơi dành cho chủ sở hữu của điểm số này.
items[]

object (LeaderboardScore)

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

LeaderboardScore

Đối tượng đ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,
  "leaderboard_id": string,
  "scoreValue": string,
  "scoreString": string,
  "publicRank": {
    object (LeaderboardScoreRank)
  },
  "socialRank": {
    object (LeaderboardScoreRank)
  },
  "friendsRank": {
    object (LeaderboardScoreRank)
  },
  "timeSpan": enum (ScoreTimeSpan),
  "writeTimestamp": string,
  "scoreTag": string
}
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 games#playerLeaderboardScore cố định.
leaderboard_id

string

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

string (int64 format)

Giá trị số của điểm 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 mình.
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 của điểm số trong tập hợ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 số này.
writeTimestamp

string (int64 format)

Dấu thời gian mà điểm số 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ố này. Giá trị không được chứa quá 64 ký tự an toàn cho URI như được xác đị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
}
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 games#leaderboardScoreRank cố định.
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 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 chuỗi.

ScoreTimeSpan

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

Enum
ALL_TIME Tỷ số này là điểm số từ trước đến nay.
WEEKLY Điểm số là điểm số hằng 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à thứ hạng (không bắt buộc) trong bảng xếp hạng dành cho người chơi đang đượ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ừ hàng đầu.

listWindow

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

submit

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

submitMultiple

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