Scores: submit

注意：需要授權。

將分數提交到指定的排行榜。 立即試用。

要求

HTTP 要求

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

參數

參數名稱	值	說明
路徑參數
leaderboardId	string	排行榜的 ID。
必要查詢參數
score	long	您提交的分數。如果提交分數低於先前提交的分數，系統會忽略該分數。分數較短，取決於排行榜的排序順序。分數值的意義取決於排行榜格式類型。如果是固定點，分數代表原始值。時間則代表經過的時間，以毫秒為單位。以貨幣來說，分數代表以微量單位表示的值。
選用查詢參數
language	string	此方法傳回的字串偏好語言。
scoreTag	string	關於這項分數的其他資訊。根據 RFC 3986 第 2.3 節的定義，值最多只能包含 64 個 URI 安全字元。

授權

此要求需要以下範圍的授權：

範圍
https://www.googleapis.com/auth/games

詳情請參閱驗證和授權頁面。

要求主體

請不要透過此方法提供請求主體。

回應

如果成功的話，這個方法會傳回回應內文，其結構如下：

{
  "kind": "games#playerScoreResponse",
  "beatenScoreTimeSpans": [
    string
  ],
  "unbeatenScores": [
    {
      "kind": "games#playerScore",
      "timeSpan": string,
      "score": long,
      "formattedScore": string,
      "scoreTag": string
    }
  ],
  "formattedScore": string,
  "leaderboardId": string,
  "scoreTag": string
}

屬性名稱	值	說明	Notes
kind	string	用於識別這項資源的類型。值一律為固定字串 games#playerScoreResponse。
beatenScoreTimeSpans[]	list	該時段的提交分數高於該時間範圍的現有分數。 可能的值包括： "ALL_TIME" - 分數為歷來分數。 「WEEKLY」：每週分數。 「DAILY」：每日分數。
unbeatenScores[]	list	那些尚未被打破的時距。例如，提交的分數可能高於玩家的 DAILY 分數，但優於玩家在 WEEKLY 或 ALL_TIME 時間範圍內的分數。
unbeatenScores[].kind	string	用於識別這項資源的類型。值一律為固定字串 games#playerScore。
unbeatenScores[].timeSpan	string	此玩家分數的時間範圍。 可能的值包括： "ALL_TIME" - 分數為歷來分數。 「WEEKLY」：每週分數。 「DAILY」：每日分數。 可接受的值如下： 「ALL_TIME」 「DAILY」 「WEEKLY」
unbeatenScores[].score	long	此玩家分數的數值。
unbeatenScores[].formattedScore	string	此玩家分數的格式化分數。
unbeatenScores[].scoreTag	string	這項分數的其他資訊。值由 RFC 3986 的第 2.3 部分定為的最多為 64 條 URI 安全字符。
formattedScore	string	提交分數的格式化值。
leaderboardId	string	提交這個分數的排行榜 ID。
scoreTag	string	這項分數的其他資訊。值由 RFC 3986 的第 2.3 部分定為的最多為 64 條 URI 安全字符。

試試看！

使用 APIs Explorer 針對即時資料呼叫這個方法，並查看回應。