Method: scores.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. Đối với một khoảng thời gian cụ thể, bạn có thể thiết lập leaderboardId thành ALL để truy xuất dữ liệu cho tất cả các bảng xếp hạng trong một khoảng thời gian nhất định. `LƯU Ý: Bạn không thể yêu cầu bảng xếp hạng 'TẤT CẢ' và khoảng thời gian 'TẤT CẢ' trong cùng một yêu cầu; chỉ có thể đặt một tham số thành 'TẤT CẢ'.

Yêu cầu HTTP

GET https://games.googleapis.com/games/v1/players/{playerId}/leaderboards/{leaderboardId}/scores/{timeSpan}

Tham số đường dẫn

Các tham số
playerId

string

Mã nhận dạng người chơi. Giá trị của me có thể được sử dụng thay cho mã của người chơi đã xác thực.
leaderboardId

string

Mã của bảng xếp hạng. Có thể đặt thành 'TẤT CẢ' để truy xuất dữ liệu cho tất cả các bảng xếp hạng cho ứng dụng này.
timeSpan

enum (ScoreTimeSpan)

Khoảng thời gian cho điểm số và thứ hạng mà bạn yêu cầu.

Tham số truy vấn

Các tham số
language

string

Ngôn ngữ ưu tiên dùng cho các chuỗi được phương thức này trả về.
includeRankType

enum (IncludeRankType)

Các loại thứ hạng cần trả về. Nếu tham số này bị bỏ qua, thì hệ thống sẽ không trả về thứ hạng.
maxResults

integer

Số điểm bảng xếp hạng tối đa cần trả về trong câu trả lời. Đối với mọi câu trả lời, số điểm thực tế trên bảng xếp hạng được trả về có thể nhỏ hơn maxResults đã chỉ định.
pageToken

string

Mã thông báo được yêu cầu trước đó trả về.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một phiên bản của GetLeaderboardScoresResponse.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

ScoreTimeSpan

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

Enum
ALL Nhận điểm số cao trong mọi khoảng thời gian. Nếu thuộc tính này được sử dụng, các giá trị maxResults sẽ bị bỏ qua.
ALL_TIME Nhận điểm số cao nhất từ trước đến nay.
WEEKLY Liệt kê các điểm số cao nhất cho ngày hiện tại.
DAILY Liệt kê các điểm số cao nhất trong tuần hiện tại.

IncludeRankType

Giá trị có thể cho loại xếp hạng.

Enum
ALL Truy xuất tất cả các thứ hạng được hỗ trợ. Trong HTTP, giá trị tham số này cũng có thể được chỉ định là ALL.
PUBLIC Truy xuất thứ hạng công khai nếu người chơi chia sẻ công khai hoạt động chơi của họ.
SOCIAL

(Lỗi thời) Truy xuất thứ hạng xã hội.
FRIENDS Truy xuất thứ hạng trên bộ sưu tập bạn bè.