方法:scores.submit

将分数提交到指定的排行榜。

HTTP 请求

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

路径参数

参数
leaderboardId

string

排行榜 ID。

查询参数

参数
language

string

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

score

string (int64 格式)

必填。您提交的分数。如果提交的分数低于之前提交的分数,则会被忽略;低于的判断标准取决于排行榜的排序顺序。分数值的含义取决于排行榜格式类型。对于定点数,分数表示原始值。对于时间,分数表示以毫秒为单位的经过时间。对于货币,分数表示以微单位表示的值。

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 概览