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

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

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

AchievementIncrement

המטען הייעודי שצריך לבקש להוספת הישג.

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

string

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

integer

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

string (int64 format)

ה-RequestId המשויך לצבירה להישג.

SetAchievementSteps

המטען הייעודי שצריך לבקש להוספת הישג.

ייצוג 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

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

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