Method: scores.submit

向指定排行榜提交得分。

HTTP 请求

POST https://games.googleapis.com/games/v1/leaderboards/{leaderboardId}/scores

路径参数

参数
leaderboardId

string

排行榜的 ID。

查询参数

参数
language

string

此方法返回的字符串使用的首选语言。

score

string (int64 format)

必需。您提交的得分。如果提交的得分低于之前提交的得分,则会被忽略,其中较差的得分取决于排行榜的排序顺序。得分值的含义取决于排行榜格式类型。对于定点数,得分表示原始值。对于时间,得分表示经过的时间(以毫秒为单位)。对于货币,得分表示以微单位表示的值。

scoreTag

string

与您所提交的评分有关的其他信息。值包含的 URI 安全字符不得超过 64 个(如 RFC 3986 第 2.3 节所定义)。

请求正文

请求正文必须为空。

响应正文

如果成功,则响应正文包含一个 SubmitLeaderboardScoreResponse 实例。

授权范围

需要以下 OAuth 范围之一:

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

有关详情,请参阅 OAuth 2.0 概览