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

提交分數的其他資訊。根據 RFC 3986 第 2.3 節的定義,值最多只能包含 64 個 URI 安全字元。

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會包含 SubmitLeaderboardScoreResponse 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍:

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

詳情請參閱 OAuth 2.0 總覽