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 總覽。