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

有关您要提交的评分的更多信息。值不得超过 64 个 URI 安全字符（如 RFC 3986 的第 2.3 节所定义）。

请求正文

请求正文必须为空。

响应正文

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

授权范围

需要以下 OAuth 范围之一：

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

如需了解详情，请参阅 OAuth 2.0 概览。