- בקשת HTTP
- גוף הבקשה
- גוף התשובה
- היקפי ההרשאות
- UpdateMultipleAchievements
- UpdateAchievement
- AchievementUpdateType
- AchievementIncrement
- SetAchievementSteps
- UpdatedAchievement
- UpdatedAchievementState
- רוצים לנסות?
מעדכנות מספר הישגים בנגן המאומת.
בקשת HTTP
POST https://games.googleapis.com/games/v1/achievements/updateMultiple
גוף הבקשה
גוף הבקשה מכיל מופע של UpdateMultipleAchievements
.
גוף התשובה
הודעת תגובה להישגים.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 |
המטען הייעודי (Payload) אם התבקש עדכון מסוג |
setStepsAtLeastPayload |
המטען הייעודי (Payload) אם התבקש עדכון מסוג |
AchievementUpdateType
סוגי עדכון אפשריים של הישגים.
טיפוסים בני מנייה (enum) | |
---|---|
REVEAL |
ההישג ייחשף. |
UNLOCK |
ההישג בוטלה. |
INCREMENT |
ההישג גדל. |
SET_STEPS_AT_LEAST |
ההתקדמות בהישגים מוגדרת לפחות לערך שהועבר. |
AchievementIncrement
המטען הייעודי (Payload) שיש לבקש להגדלת הישג.
ייצוג JSON |
---|
{ "kind": string, "steps": integer, "requestId": string } |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
steps |
מספר השלבים שיש להגדיל. |
requestId |
ה-requestId שמשויך להגדלה להישג. |
SetAchievementSteps
המטען הייעודי (Payload) שיש לבקש להגדלת הישג.
ייצוג JSON |
---|
{ "kind": string, "steps": integer } |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
steps |
מספר השלבים המינימלי להגדרת ההישג. |
UpdatedAchievement
הישג מעודכן.
ייצוג JSON |
---|
{
"kind": string,
"achievementId": string,
"updateOccurred": boolean,
"currentState": enum ( |
שדות | |
---|---|
kind |
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה |
achievementId |
ההישג שעליו בוצע העדכון הזה. |
updateOccurred |
האם העדכונים המבוקשים השפיעו בפועל על ההישג. |
currentState |
המצב הנוכחי של ההישג. |
currentSteps |
השלבים הנוכחיים שתועדו להישג הזה, אם הוא מצטברים. |
newlyUnlocked |
האם ההישג הזה נפתח לאחרונה (כלומר, אם בקשת ביטול הנעילה של ההישג הייתה הראשונה עבור השחקן). |
UpdatedAchievementState
מצבי הישגים מעודכנים אפשריים.
טיפוסים בני מנייה (enum) | |
---|---|
HIDDEN |
ההישג מוסתר. |
REVEALED |
ההישג ייחשף. |
UNLOCKED |
ההישג בוטלה. |