Method: achievements.increment
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Erhöht die Schritte des Erfolgs mit der angegebenen ID für den derzeit authentifizierten Spieler.
HTTP-Anfrage
POST https://games.googleapis.com/games/v1/achievements/{achievementId}/increment
Pfadparameter
| Parameter |
achievementId |
string
Die ID des von dieser Methode verwendeten Erfolgs.
|
Abfrageparameter
| Parameter |
requestId |
string (int64 format)
Eine zufällig generierte numerische ID für jede vom Aufrufer angegebene Anfrage. Diese Nummer wird auf dem Server verwendet, um sicherzustellen, dass die Anfrage bei mehreren Wiederholungen korrekt verarbeitet wird.
|
stepsToIncrement |
integer
Erforderlich. Die Anzahl der zu erhöhenden Schritte.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Antwort zur Erhöhung des Erfolgs
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"kind": string,
"currentSteps": integer,
"newlyUnlocked": boolean
} |
| Felder |
kind |
string
Kennzeichnet den Typ dieser Ressource eindeutig. Der Wert ist immer der feste String games#achievementIncrementResponse.
|
currentSteps |
integer
Die aktuellen Schritte, die für diesen inkrementellen Erfolg erfasst wurden.
|
newlyUnlocked |
boolean
Gibt an, ob die aktuellen Schritte für den Erfolg die Anzahl der erforderlichen Schritte zum Freischalten erreicht haben.
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/games
https://www.googleapis.com/auth/games_lite
Weitere Informationen finden Sie in der Übersicht über OAuth 2.0.
Alle Inhalte und Codebeispiele auf dieser Seite unterliegen den Lizenzen wie im Abschnitt Inhaltslizenz beschrieben. Java und OpenJDK sind Marken oder eingetragene Marken von Oracle und/oder seinen Tochtergesellschaften.
Zuletzt aktualisiert: 2025-07-27 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-27 (UTC)."],[],[],null,["# Method: achievements.increment\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.IncrementAchievementResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nIncrements the steps of the achievement with the given ID for the currently authenticated player.\n\n### HTTP request\n\n`POST https://games.googleapis.com/games/v1/achievements/{achievementId}/increment`\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| `requestId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` A randomly generated numeric ID for each request specified by the caller. This number is used at the server to ensure that the request is handled correctly across retries. |\n| `stepsToIncrement` | `integer` Required. The number of steps to increment. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nAn achievement increment 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#achievementIncrementResponse`. |\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)."]]
