Scores: get

在排行榜中获得当前已通过身份验证的玩家的高分（也可以选择排名）。对于特定时间范围，可以将 leaderboardId 设置为 ALL，以检索给定时间范围内所有排行榜的数据。
注意：您不能在同一请求中请求“ALL”排行榜和“ALL”timeSpan；只能将一个参数设置为“ALL”。立即试用。

请求

HTTP 请求

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

参数

参数名称 值 说明
路径参数
leaderboardId string 排行榜的 ID。可以设置为“ALL”，以检索此应用的所有排行榜的数据。
playerId string 玩家 ID。值 me 可用于替代经过验证的玩家 ID。
timeSpan string 您请求的得分和排名的时间范围。

可接受的值：
  • “ALL”：获得所有时间跨度的高分。如果使用此值，maxResults 值将被忽略。
  • “ALL_TIME”：获得历史最高得分。
  • “DAILY”：列出当天的最高得分。
  • “WEEKLY”：列出本周的最高得分。
可选的查询参数
includeRankType string 要返回的排名类型。如果省略此参数，则系统不会返回任何排名。

可接受的值：
  • “ALL”：检索所有受支持的排名。
  • “FRIENDS”：检索好友集合的排名。
  • “PUBLIC”：如果玩家公开分享游戏活动，则检索公开排名。
  • “SOCIAL”：（已过时）旧版 Google+ 社交排行榜排名，始终为 1。
language string 此方法返回的字符串的首选语言。
maxResults integer 响应中可返回的排行榜得分上限。对于任何响应，返回的实际排行榜得分都可能小于指定的 maxResults。可接受的值包括 1 到 30（含）。
pageToken string 上一个请求返回的令牌。

授权

此请求需要获得以下范围的授权：

范围
https://www.googleapis.com/auth/games

如需了解详情，请参阅身份验证和授权页面。

请求正文

使用此方法时请勿提供请求正文。

响应

如果成功，此方法将在响应正文中返回 Scores 资源。

试试看！

请使用下面的 API Explorer 针对实际数据调用此方法，然后查看响应。