Method: achievements.unlock

為目前驗證的玩家解鎖這項成就。

HTTP 要求

POST https://games.googleapis.com/games/v1/achievements/{achievementId}/unlock

路徑參數

參數
achievementId

string

這個方法使用的關卡 ID。

要求主體

要求主體必須為空白。

回應主體

關卡解鎖回應

如果成功，回應主體即會包含具有以下結構的資料：

JSON 表示法 
{
  "kind": string,
  "newlyUnlocked": boolean
}
欄位
kind

string

專門識別這個資源的類型。值一律為固定字串 games#achievementUnlockResponse。
newlyUnlocked

boolean

此關卡是否最近剛解鎖 (也就是玩家第一次獲得成就的解鎖要求)。

授權範圍

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

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

詳情請參閱 OAuth 2.0 總覽。