Method: scores.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.

Yêu cầu HTTP

GET https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/window/{collection}

Tham số đường dẫn

Các tham số
leaderboardId

string

Mã của bảng xếp hạng.
collection

enum (ScoreCollection)

Tập hợp các điểm số 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ề.
timeSpan

enum (ScoreTimeSpan)

Bắt buộc. Khoảng thời gian cho điểm số và thứ hạng mà bạn yêu cầu.
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.
resultsAbove

integer

Số điểm mong muốn trả về cao hơn điểm của người chơi. Có thể trả về nhiều điểm hơn nếu người chơi ở cuối bảng xếp hạng. Người chơi có thể trả về ít điểm hơn nếu người chơi ở đầu bảng xếp hạng. Phải nhỏ hơn hoặc bằng maxResults.
returnTopIfAbsent

boolean

Đúng nếu điểm số cao nhất được trả về khi người chơi không có trong bảng xếp hạng. Giá trị mặc định là đúng.
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 ListLeaderboardScoresResponse.

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.