Method: achievements.updateMultiple

מעדכנות מספר הישגים בנגן המאומת.

בקשת HTTP

POST https://games.googleapis.com/games/v1/achievements/updateMultiple

גוף הבקשה

גוף הבקשה מכיל מופע של UpdateMultipleAchievements.

גוף התשובה

הודעת תגובה להישגים.updateMultiple rpc.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג JSON 
{
  "kind": string,
  "updatedAchievements": [
    {
      object (UpdatedAchievement)
    }
  ]
}
שדות
kind

string

מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#achievementUpdateMultipleResponse.
updatedAchievements[]

object (UpdatedAchievement)

מצב ההישגים המעודכן.

היקפי ההרשאות

נדרש אחד מהיקפי ההרשאות הבאים של OAuth:

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

למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.

UpdateMultipleAchievements

רשימת בקשות לעדכון הישגים.

ייצוג JSON 
{
  "kind": string,
  "updates": [
    {
      object (UpdateAchievement)
    }
  ]
}
שדות
kind

string

מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#achievementUpdateMultipleRequest.
updates[]

object (UpdateAchievement)

בקשות לעדכון הישגים אישיים.

UpdateAchievement

בקשה לעדכון הישג.

ייצוג JSON 
{
  "kind": string,
  "achievementId": string,
  "updateType": enum (AchievementUpdateType),
  "incrementPayload": {
    object (AchievementIncrement)
  },
  "setStepsAtLeastPayload": {
    object (SetAchievementSteps)
  }
}
שדות
kind

string

מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#achievementUpdateRequest.
achievementId

string

ההישג שעליו העדכון הזה מוחל.
updateType

enum (AchievementUpdateType)

סוג העדכון שמיושם.
incrementPayload

object (AchievementIncrement)

המטען הייעודי (Payload) אם התבקש עדכון מסוג INCREMENT להישג.
setStepsAtLeastPayload

object (SetAchievementSteps)

המטען הייעודי (Payload) אם התבקש עדכון מסוג SET_STEPS_AT_LEAST להישג.

AchievementUpdateType

סוגי עדכון אפשריים של הישגים.

טיפוסים בני מנייה (enum)
REVEAL ההישג ייחשף.
UNLOCK ההישג בוטלה.
INCREMENT ההישג גדל.
SET_STEPS_AT_LEAST ההתקדמות בהישגים מוגדרת לפחות לערך שהועבר.

AchievementIncrement

המטען הייעודי (Payload) שיש לבקש להגדלת הישג.

ייצוג JSON 
{
  "kind": string,
  "steps": integer,
  "requestId": string
}
שדות
kind

string

מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#GamesAchievementIncrement.
steps

integer

מספר השלבים שיש להגדיל.
requestId

string (int64 format)

ה-requestId שמשויך להגדלה להישג.

SetAchievementSteps

המטען הייעודי (Payload) שיש לבקש להגדלת הישג.

ייצוג JSON 
{
  "kind": string,
  "steps": integer
}
שדות
kind

string

מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#GamesAchievementSetStepsAtLeast.
steps

integer

מספר השלבים המינימלי להגדרת ההישג.

UpdatedAchievement

הישג מעודכן.

ייצוג JSON 
{
  "kind": string,
  "achievementId": string,
  "updateOccurred": boolean,
  "currentState": enum (UpdatedAchievementState),
  "currentSteps": integer,
  "newlyUnlocked": boolean
}
שדות
kind

string

מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#achievementUpdateResponse.
achievementId

string

ההישג שעליו בוצע העדכון הזה.
updateOccurred

boolean

האם העדכונים המבוקשים השפיעו בפועל על ההישג.
currentState

enum (UpdatedAchievementState)

המצב הנוכחי של ההישג.
currentSteps

integer

השלבים הנוכחיים שתועדו להישג הזה, אם הוא מצטברים.
newlyUnlocked

boolean

האם ההישג הזה נפתח לאחרונה (כלומר, אם בקשת ביטול הנעילה של ההישג הייתה הראשונה עבור השחקן).

UpdatedAchievementState

מצבי הישגים מעודכנים אפשריים.

טיפוסים בני מנייה (enum)
HIDDEN ההישג מוסתר.
REVEALED ההישג ייחשף.
UNLOCKED ההישג בוטלה.