Method: achievements.setStepsAtLeast
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
מגדיר את השלבים של השחקן שאומת כדי לבטל את הנעילה של הישג. אם פרמטר השלבים קטן ממספר השלבים הנוכחי שהשחקן כבר צבר עבור ההישג, ההישג לא ישתנה.
בקשת HTTP
POST https://games.googleapis.com/games/v1/achievements/{achievementId}/setStepsAtLeast
פרמטרים של נתיב
| פרמטרים |
achievementId |
string
המזהה של ההישג בשיטה הזו.
|
פרמטרים של שאילתה
| פרמטרים |
steps |
integer
חובה. הערך המינימלי שיש להגדיר אליו את השלבים.
|
גוף הבקשה
גוף הבקשה חייב להיות ריק.
גוף התשובה
הישג שהוגדר לשלבים (לפחות) תגובה.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
| ייצוג JSON |
{
"kind": string,
"currentSteps": integer,
"newlyUnlocked": boolean
} |
| שדות |
kind |
string
מזהה באופן ייחודי את סוג המשאב הזה. הערך הוא תמיד המחרוזת הקבועה games#achievementSetStepsAtLeastResponse.
|
currentSteps |
integer
השלבים הנוכחיים שתועדו עבור ההישג המצטבר הזה.
|
newlyUnlocked |
boolean
האם מספר השלבים שנדרשים להישג הגיע למספר השלבים שצריך לבצע כדי לבטל את הנעילה.
|
היקפי ההרשאות
נדרש אחד מהיקפי ההרשאות הבאים של OAuth:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
למידע נוסף, קראו את המאמר סקירה כללית של OAuth 2.0.
דוגמאות התוכן והקוד שבדף הזה כפופות לרישיונות המפורטים בקטע רישיון לתוכן. Java ו-OpenJDK הם סימנים מסחריים או סימנים מסחריים רשומים של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-27 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-27 (שעון UTC)."],[],[],null,["# Method: achievements.setStepsAtLeast\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SetAchievementStepsAtLeastResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nSets the steps for the currently authenticated player towards unlocking an achievement. If the steps parameter is less than the current number of steps that the player already gained for the achievement, the achievement is not modified.\n\n### HTTP request\n\n`POST https://games.googleapis.com/games/v1/achievements/{achievementId}/setStepsAtLeast`\n\n### Path parameters\n\n| Parameters ||\n|-----------------|---------------------------------------------------------|\n| `achievementId` | `string` The ID of the achievement used by this method. |\n\n### Query parameters\n\n| Parameters ||\n|---------|------------------------------------------------------------|\n| `steps` | `integer` Required. The minimum value to set the steps to. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nAn achievement set steps at least response.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"currentSteps\": integer, \"newlyUnlocked\": boolean } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Uniquely identifies the type of this resource. Value is always the fixed string `games#achievementSetStepsAtLeastResponse`. |\n| `currentSteps` | `integer` The current steps recorded for this incremental achievement. |\n| `newlyUnlocked` | `boolean` Whether the current steps for the achievement has reached the number of steps required to unlock. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/games`\n- `\n https://www.googleapis.com/auth/games_lite`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]
