- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- ScoreTimeSpan
- IncludeRankType
- Hãy làm thử!
Đạ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 |
Mã nhận dạng người chơi. Giá trị của |
leaderboardId |
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 |
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 |
Ngôn ngữ ưu tiên dùng cho các chuỗi được phương thức này trả về. |
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 |
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 |
pageToken |
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è. |