- HTTP 要求
- 要求主體
- 回應主體
- 授權範圍
- UpdateMultipleAchievements
- UpdateAchievement
- AchievementUpdateType
- AchievementIncrement
- SetAchievementSteps
- UpdatedAchievement
- UpdatedAchievementState
- 試試看!
為目前驗證玩家更新多個成就。
HTTP 要求
POST https://games.googleapis.com/games/v1/achievements/updateMultiple
要求主體
要求主體包含 UpdateMultipleAchievements
的例項。
回應主體
「Achieve.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 |
成就已解鎖。 |