- HTTP 要求
- 要求主體
- 回應主體
- 授權範圍
- UpdateMultipleAchievements
- UpdateAchievement
- AchievementUpdateType
- AchievementIncrement
- SetAchievementSteps
- UpdatedAchievement
- UpdatedAchievementState
- 試試看!
為目前已驗證的玩家更新多個成就。
HTTP 要求
POST https://games.googleapis.com/games/v1/achievements/updateMultiple
要求主體
要求主體包含 UpdateMultipleAchievements
的例項。
回應主體
Achieves.updateMultiple rpc 的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"kind": string,
"updatedAchievements": [
{
object ( |
欄位 | |
---|---|
kind |
專門識別這個資源的類型。值一律為固定字串 |
updatedAchievements[] |
關卡的更新狀態。 |
授權範圍
需要下列其中一種 OAuth 範圍:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
詳情請參閱 OAuth 2.0 總覽。
UpdateMultipleAchievements
關卡更新要求清單。
JSON 表示法 |
---|
{
"kind": string,
"updates": [
{
object ( |
欄位 | |
---|---|
kind |
專門識別這個資源的類型。值一律為固定字串 |
updates[] |
個別關卡更新要求。 |
UpdateAchievement
更新關卡的要求。
JSON 表示法 |
---|
{ "kind": string, "achievementId": string, "updateType": enum ( |
欄位 | |
---|---|
kind |
專門識別這個資源的類型。值一律為固定字串 |
achievementId |
套用這項更新的成就。 |
updateType |
正在套用的更新類型。 |
incrementPayload |
如果要求更新成就類型 |
setStepsAtLeastPayload |
如果要求更新成就類型 |
AchievementUpdateType
可能的成就更新類型。
列舉 | |
---|---|
REVEAL |
成果已揭示, |
UNLOCK |
已解鎖成就。 |
INCREMENT |
成就遞增。 |
SET_STEPS_AT_LEAST |
請將成就進度設為至少傳遞的值。 |
AchievementIncrement
用來要求增加關卡的酬載。
JSON 表示法 |
---|
{ "kind": string, "steps": integer, "requestId": string } |
欄位 | |
---|---|
kind |
專門識別這個資源的類型。值一律為固定字串 |
steps |
要增加的步數。 |
requestId |
與關卡遞增相關聯的 requestId。 |
SetAchievementSteps
用來要求增加關卡的酬載。
JSON 表示法 |
---|
{ "kind": string, "steps": integer } |
欄位 | |
---|---|
kind |
專門識別這個資源的類型。值一律為固定字串 |
steps |
設定關卡所需的最低步驟數。 |
UpdatedAchievement
已更新成就。
JSON 表示法 |
---|
{
"kind": string,
"achievementId": string,
"updateOccurred": boolean,
"currentState": enum ( |
欄位 | |
---|---|
kind |
專門識別這個資源的類型。值一律為固定字串 |
achievementId |
套用這項更新的成就。 |
updateOccurred |
要求的更新是否確實影響了成就。 |
currentState |
關卡目前的狀態。 |
currentSteps |
此成就目前記錄的步數 (若為漸進式)。 |
newlyUnlocked |
此關卡是否最近剛解鎖 (也就是玩家第一次獲得成就的解鎖要求)。 |
UpdatedAchievementState
可能的更新成就狀態。
列舉 | |
---|---|
HIDDEN |
已隱藏成就。 |
REVEALED |
成果已揭示, |
UNLOCKED |
已解鎖成就。 |