Scores: get

Nhận điểm cao và xếp hạng tùy chọn, trong bảng xếp hạng cho người chơi hiện được xác thực. Trong một khoảng thời gian cụ thể, bạn có thể đặt 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 "ALL" và "ALL" trong cùng một yêu cầu; chỉ có thể đặt một tham số thành "ALL". Thử ngay.

Yêu cầu

Yêu cầu HTTP

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

Các tham số

Tên thông số Giá trị Mô tả
Tham số đường dẫn
leaderboardId string Mã nhận dạng của bảng xếp hạng. Có thể được đặt thành "ALL" (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.
playerId string Tên nhận dạng người chơi. Hệ thống có thể sử dụng giá trị của me thay cho mã của người chơi đã xác thực.
timeSpan string Khoảng thời gian tính điểm và xếp hạng mà bạn yêu cầu.

Các giá trị được chấp nhận là:
  • "ALL": Nhận điểm cao cho tất cả các khoảng thời gian. Nếu bạn sử dụng thuộc tính này, thì giá trị maxResults sẽ bị bỏ qua.
  • "ALL_TIME": Nhận điểm cao nhất mọi thời đại.
  • "DAILY": Liệt kê các điểm số cao nhất cho ngày hiện tại.
  • "WEEKLY": Liệt kê các điểm số cao nhất trong tuần hiện tại.
Tham số truy vấn không bắt buộc
includeRankType string Các loại thứ hạng cần trả về. Nếu bạn bỏ qua thông số này, sẽ không có thứ hạng nào được trả về.

Các giá trị được chấp nhận là:
  • "ALL": Truy xuất tất cả các thứ hạng được hỗ trợ.
  • "FRIENDS": Truy xuất thứ hạng trong bộ sưu tập bạn bè.
  • "PUBLIC": Truy xuất thứ hạng công khai nếu người chơi đang chia sẻ công khai hoạt động chơi trò chơi của họ.
  • "SOCIAL": (Lỗi thời) Bảng xếp hạng xã hội cũ của G+, luôn là 1.
language string Ngôn ngữ ưu tiên để sử dụng cho các chuỗi được phương thức này trả về.
maxResults integer Số điểm tối đa của bảng xếp hạng cần trả về trong phản hồi. Đối với bất kỳ câu trả lời nào, số điểm thực tế của bảng xếp hạng có thể thấp hơn maxResults đã chỉ định. Giá trị được chấp nhận là từ 1 đến 30, bao gồm cả hai giá trị này.
pageToken string Mã thông báo được yêu cầu trước đó trả về.

Ủy quyền

Yêu cầu này cần được cho phép với phạm vi sau:

Phạm vi
https://www.googleapis.com/auth/games

Để biết thêm thông tin, hãy xem trang xác thực và uỷ quyền.

Nội dung yêu cầu

Đừng cung cấp nội dung yêu cầu bằng phương thức này.

Phản hồi

Nếu thành công, phương thức này sẽ trả về một Tài nguyên điểm số trong nội dung phản hồi.

Hãy dùng thử!

Hãy dùng API Explorer bên dưới để gọi phương thức này trên dữ liệu trực tiếp và xem phản hồi.